SuperAPI AI 工具集

unified-diff-mcp

unified-diff-mcp 是一个面向 Claude Desktop 的 MCP(Model Context Protocol)服务器工具,主要用于将代码差异(diff)转换为美观的可视化对比。它基于 diff2html 生成 HTML 差异视图,并支持通过 GitHub Gist 即时分享或输出为本地文件(PNG/HTML)。该项目使用 Bun 运行时,具备跨平台支持(Windows、macOS、Linux),并提供多级安全保护与临时差异自动删除功能,适合在 AI 辅助编程工作流中直观查看代码变更。

访问官网

工具介绍

用途

unified-diff-mcp 是一个为 Claude Desktop 设计的 MCP 服务器,用于将代码差异(diff)转化为美观的可视化对比页面。它帮助开发者在与 AI 助手协作时,以更直观的方式查看和理解代码变更内容。

主要能力

  • 使用 diff2html 生成美观的 HTML 差异可视化页面。
  • 集成 GitHub Gist,可将差异即时分享。
  • 支持本地文件输出,格式包括 PNG 和 HTML。
  • 对临时差异提供自动删除功能。
  • 跨平台支持:Windows、macOS、Linux。
  • 基于 Bun 运行时,具备高性能表现。
  • 提供多级安全保护(低/中/高),针对共享差异场景增强安全性。
  • 当 GitHub Token 不可用时,支持回退为本地文件处理(保存为临时 HTML、自动打开浏览器、基于安全级别管理文件)。

使用方式

可通过 Smithery 安装,或手动安装:

  1. 安装 Claude Desktop 和 Bun。
  2. 克隆并构建项目: git clone https://github.com/gorosun/unified-diff-mcp.git cd unified-diff-mcp bun install
  3. 配置 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 文件。