用途
unified-diff-mcp 是一个为 Claude Desktop 设计的 MCP 服务器,用于将代码差异(diff)转化为美观的可视化对比页面。它帮助开发者在与 AI 助手协作时,以更直观的方式查看和理解代码变更内容。
主要能力
- 使用 diff2html 生成美观的 HTML 差异可视化页面。
- 集成 GitHub Gist,可将差异即时分享。
- 支持本地文件输出,格式包括 PNG 和 HTML。
- 对临时差异提供自动删除功能。
- 跨平台支持:Windows、macOS、Linux。
- 基于 Bun 运行时,具备高性能表现。
- 提供多级安全保护(低/中/高),针对共享差异场景增强安全性。
- 当 GitHub Token 不可用时,支持回退为本地文件处理(保存为临时 HTML、自动打开浏览器、基于安全级别管理文件)。
使用方式
可通过 Smithery 安装,或手动安装:
- 安装 Claude Desktop 和 Bun。
- 克隆并构建项目: git clone https://github.com/gorosun/unified-diff-mcp.git cd unified-diff-mcp bun install
- 配置 Claude Desktop(详见项目内配置部分)。
配置过程中可设置环境变量,并需要 GitHub Token 以启用 Gist 分享功能:
- 前往 GitHub Settings > Personal Access Tokens 生成具有 gist 权限的新令牌。
- 在环境中添加:export GITHUB_TOKEN="your_token_here"
开发模式支持热重载,生产模式用于正式运行。项目提供了英文和日文的详细设置与集成指南(CLAUDE_CODE_INTEGRATION.md 和 CLAUDE_CODE_INTEGRATION_JP.md)。
适用场景
- 在 Claude Desktop 中与 AI 协作查看代码差异。
- 需要将代码 diff 以可视化方式分享给他人。
- 希望将差异输出为本地文件进行存档或展示。
限制
- 官方资料未提供具体收费信息,暂未提供。
- 官方资料未提供价格信息,暂未提供。
- 主要面向 Claude Desktop,同时也支持 Claude Code、VS Code + MCP 扩展、Cline 等 MCP 客户端,但具体兼容性细节暂未提供。
- 采用 MIT 许可证,详见 LICENSE 文件。