Unified Diff MCP

统一Diff-MCP服务器

Claude Desktop的漂亮差异可视化。通过GitHub Gist集成和本地文件输出，将代码差异转化为令人惊叹的视觉比较。

✨ 特性

• 🎨 漂亮的HTML差异可视化 使用diff2html
• 🌐 GitHub Gist集成 用于即时共享
• 📁 本地文件输出 （PNG/HTML）
• 🔄 自动删除功能 对于临时差异
• 🖥️ 与跨平台支持 （Windows、macOS、Linux）
• ⚡ 高性能 使用Bun运行时
• 🛡️ 增强的安全性 为共享差异提供多级保护
• 🔒 多级安全 （低/中/高）适用于不同的用例

🚀 快速开始

通过Smithery安装

bunx @smithery/cli install @gorosun/unified-diff-mcp --client claude --config '{
  "defaultAutoOpen": true,
  "defaultOutputMode": "html",
  "githubUsername": "your_actual_github_username",
  "githubToken": "ghp_your_actual_token_here"
}'

手动安装

1. 克隆和构建：

   git clone https://github.com/gorosun/unified-diff-mcp.git
   cd unified-diff-mcp
   bun install

1. 配置Claude桌面 -看 配置 在......下面

🛠️ 工具概述

📖 使用示例

🎯 按目的优化提示

立即分享差异（GitHub Gist）

visualize_diff_html_content:
- Creates temporary GitHub Gist
- Auto-deletes after 30 minutes
- Instant browser-ready URLs
- Perfect for code reviews

在本地保存差异

visualize_diff_output_file:
- Saves PNG or HTML to local disk
- Auto-opens in browser (optional)
- Perfect for documentation

🎛️ 配置

环境变量

GitHub令牌设置

1. 首选
2. 使用生成新令牌 gist 范围
3. 添加到您的环境中：

   export GITHUB_TOKEN="your_token_here"

Claude桌面配置

macOS：

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

窗户：

code %APPDATA%\Claude\claude_desktop_config.json

配置模板：

{
  "mcpServers": {
    "unified-diff-mcp": {
      "command": "bun",
      "args": ["run", "/path/to/unified-diff-mcp/src/index.ts"],
      "env": {
        "GITHUB_TOKEN": "your_github_token_here",
        "DEFAULT_AUTO_OPEN": "true",
        "DEFAULT_OUTPUT_MODE": "html"
      }
    }
  }
}

📋 参数参考

公共参数

GitHub Gist特定

本地文件特定

🌍 平台支持

🔧 发展

开发模式（热重载）：

{
  "command": "bun",
  "args": ["--watch", "/path/to/unified-diff-mcp/src/index.ts"]
}

生产方式：

{
  "command": "bun",
  "args": ["run", "/path/to/unified-diff-mcp/src/index.ts"]
}

📚 高级用法

🔒 增强的安全级别

当GitHub Token不可用或无法安全共享时，您可以从多个安全级别中进行选择：

用法示例

Please visualize this diff with high security:
--- a/config.js
+++ b/config.js
@@ -1,3 +1,4 @@
 const config = {
-  apiKey: 'old-key'
+  apiKey: 'new-secure-key',
+  timeout: 5000
 };

响应示例:

🔒 **Secure Diff Visualization**

🔴 **Security Level**: High Security - Secret Gist + Password (15min auto-delete)
📋 **Preview Link**: https://htmlpreview.github.io/?...
🔑 **Access Code**: `a7x9k2`
⏰ **Auto-delete**: 15 minutes

🔄 回退功能

当GitHub Token不可用时，系统会回退到本地文件：

• HTML保存为临时文件
• 自动打开浏览器
• 基于安全的文件管理

有关详细的设置和集成指南：

• 🇺🇸 英语: CLAUDE_CODE_INTEGRATION.md
• 🇯🇵 日本语: CLAUDE_CODE_INTEGRATION-JP.md

🤝 支持的客户

• 克劳德桌面 主要的，重要的
• 克劳德代码 （CLI）
• VS代码+MCP扩展
• 克莱恩 以及其他MCP客户端

📄 许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

依赖项

______________________________________________________________________

由以下材料制成❤️ 克劳德桌面社区