Delta MCP服务器
一个模型上下文协议服务器，为Cursor、Claude Code、Claude Desktop和Warp等AI助手带来了git delta美丽的语法高亮和差异格式化。与纯文本差异不同，您可以获得干净的终端风格彩色输出，看起来与原生delta完全相同，并具有可点击的浏览器链接的额外好处，以便更好地查看。
这有什么作用
当你要求AI助手向你展示git diff或解释代码更改时，该服务器会使用git delta格式化输出。这意味着您可以获得适当的语法高亮显示、并排比较、行号以及所有使差异可读的视觉增强。该服务器与MCP兼容的客户端无缝集成，因此您可以使用自然语言请求格式化的差异、责任信息、grep结果等。
服务器还支持终端超链接，因此当您在终端中查看差异时，可以单击链接在浏览器中打开它，以获得更好的查看体验。所有格式化的输出都保存为HTML文件，保存在磁盘上，便于共享或标记特定的差异。
需求
你需要Python 3.10或更高版本，并且必须安装git delta。安装delta最简单的方法是使用cargo： cargo install git-delta。您还需要安装Git，我建议使用uv进行依赖管理，尽管pip也可以很好地工作。
安装
根据您的使用方式，有几种方法可以设置它。对于Claude Desktop用户，有一个MCPB包提供一键安装。如果你更喜欢pip，你可以将其作为包安装。对于开发或自定义设置，您可以克隆存储库并手动设置。
对于开发设置，如果您还没有安装uv，请先安装它。然后克隆存储库，创建一个虚拟环境 uv venv，激活它，并安装依赖项 uv pip install -e .。服务器将准备运行。
配置
Delta使用Git的配置格式，因此您可以通过添加 [delta] 部分到您的 ~/.gitconfig 文件。您可以设置语法主题、启用并排视图、启用行号和配置其他选项。中有一个示例配置文件 config 显示所有可用选项的目录。
对于MCP客户端配置，您需要将服务器添加到客户端的配置文件中。确切的位置取决于您使用的客户端。对于Claude Desktop，它位于应用程序支持目录中。对于Claude Code，请使用应用程序中的MCP设置。对于Cursor，您可以在“设置”中使用基于UI的设置，也可以手动编辑配置文件。Warp使用类似的JSON配置格式。示例配置文件在示例目录中为每个客户端提供。
要记住的关键是使用绝对路径，而不是相对路径。在Windows上，确保在路径中使用双反斜杠或正斜杠。更改配置后，您需要完全退出并重新启动客户端，而不仅仅是关闭窗口。
用法
配置后，您可以使用自然语言通过AI助手与服务器交互。让它显示特定提交的格式化差异，用补丁格式化git日志，在代码库中搜索模式，或比较两个文件。服务器自动处理所有格式。
克劳德的快速示例
基本用法：
- “显示上次提交的差异”
- “格式化server.py的git diff”
- “HEAD~1发生了什么变化？”
CLI模式（无浏览器链接）：
- “在CLI模式下显示差异”
- “使用CLI模式显示上次提交”
浏览器模式（带有可点击的链接）：
- “显示差异并在浏览器中打开它”
- “使用浏览器链接格式化差异”
看 用法.md 查看详细示例和所有可用工具。
服务器提供了几个AI助手可以使用的工具。这些包括格式化git差异、显示提交详细信息、显示带有补丁的git日志、显示错误信息、格式化grep结果、显示合并冲突、语法突出显示代码片段以及直接比较文件。
还有一些资源可以直接访问格式化数据。您可以访问特定提交的格式化差异、文件的错误信息、模式的grep结果、当前的增量配置和可用语法主题列表。
安全
服务器包括输入验证，以防止常见的安全问题。文件路径经过验证，以确保它们位于git存储库或当前工作目录中，从而防止路径遍历攻击。提交范围使用正则表达式模式进行验证。Grep工具仅限于安全工具的白名单：Grep、ripgrep和git Grep。
故障排除
如果您看到找不到Delta的错误，请确保您已使用 cargo install git-delta。您可以通过运行以下命令来验证安装 delta --version。如果在非标准位置安装了增量，则可以在MCPB清单中配置路径。
如果你的Git配置没有加载，请检查你的 ~/.gitconfig 文件存在并且语法正确。Delta使用INI格式，而不是TOML。您还可以设置 GIT_CONFIG_GLOBAL 环境变量指向不同的配置文件。
当服务器没有出现在客户端时，最常见的问题是配置文件中的JSON无效，使用相对路径而不是绝对路径，或者在更改后没有完全重新启动客户端。确保完全退出应用程序，而不仅仅是关闭窗口。
如果工具调用失败，请检查客户端的日志文件。对于Claude Desktop，日志位于logs目录中。您还可以通过运行以下命令手动测试服务器 uv run server.py 查看是否有任何错误。
发展
要运行测试套件，请安装开发依赖项 uv pip install -e ".[dev]" 然后跑 pytest测试涵盖了验证、配置管理和git实用程序。
要构建用于分发的MCPB包，请使用npm将MCPB CLI作为开发依赖项安装，然后运行 npx @anthropic-ai/mcpb pack 以创建捆绑包文件。
要构建pip包，请使用 python -m build 要创建分发文件，请使用以下命令上传 twine upload dist/*.
许可证
该项目根据MIT许可证获得许可。
致谢
此服务器构建在git delta之上，git delta是一个出色的diff工具，提供语法突出显示和格式化功能。它使用模型上下文协议规范与AI助手集成，并使用FastMCP框架进行快速开发。