git MCP server

mcp-server-git：一个 git MCP 服务器

概述

用于 Git 仓库交互和自动化的模型上下文协议服务器。该服务器提供通过大型语言模型读取、搜索和操作 Git 仓库的工具。

请注意，mcp-server-git 目前处于早期开发阶段。随着我们不断开发和改进服务器，其功能和可用工具可能会有所变更和扩展。

工具

1. git_status
   • 显示工作树状态
   • 输入：
     • repo_path （字符串）：Git 存储库的路径
   • 返回：以文本输出的形式返回工作目录的当前状态
2. git_diff_unstaged
   • 显示工作目录中尚未暂存的更改
   • 输入：
     • repo_path （字符串）：Git 存储库的路径
   • 返回：未暂存更改的差异输出
3. git_diff_staged
   • 显示已提交的更改
   • 输入：
     • repo_path （字符串）：Git 存储库的路径
   • 返回：阶段性变化的差异输出
4. git_diff
   • 显示分支或提交之间的差异
   • 输入：
     • repo_path （字符串）：Git 存储库的路径
     • target （字符串）：要比较的目标分支或提交
   • 返回：比较当前状态与目标的差异输出
5. git_commit
   • 记录存储库的更改
   • 输入：
     • repo_path （字符串）：Git 存储库的路径
     • message （字符串）：提交消息
   • 返回：使用新的提交哈希确认
6. git_add
   • 将文件内容添加到暂存区
   • 输入：
     • repo_path （字符串）：Git 存储库的路径
     • files （string[]）：要暂存的文件路径数组
   • 返回：暂存文件的确认
7. git_reset
   • 取消暂存所有已暂存的更改
   • 输入：
     • repo_path （字符串）：Git 存储库的路径
   • 返回：重置操作确认
8. git_log
   • 显示提交日志
   • 输入：
     • repo_path （字符串）：Git 存储库的路径
     • max_count （数字，可选）：显示的最大提交数（默认值：10）
   • 返回：包含哈希、作者、日期和消息的提交条目数组
9. git_create_branch
   • 创建新分支
   • 输入：
     • repo_path （字符串）：Git 存储库的路径
     • branch_name （字符串）：新分支的名称
     • start_point （字符串，可选）：新分支的起点
   • 返回：确认分支创建
10. git_checkout

• 切换分支
• 输入：
  • repo_path （字符串）：Git 存储库的路径
  • branch_name （字符串）：要检出的分支的名称
• 返回：分支切换确认

11. git_show

• 显示提交的内容
• 输入：
  • repo_path （字符串）：Git 存储库的路径
  • revision （字符串）：要显示的修订（提交哈希、分支名称、标签）
• 返回：指定提交的内容

12. git_init

• 初始化 Git 存储库
• 输入：
  • repo_path (字符串)：初始化 git repo 的目录路径
• 返回：存储库初始化的确认

安装

使用 uv（推荐）

使用uv时无需特殊安装。我们将使用uvx直接运行mcp-server-git 。

使用 PIP

或者，您可以通过 pip 安装mcp-server-git ：

安装后，您可以使用以下命令将其作为脚本运行：

配置

与 Claude Desktop 一起使用

将其添加到您的claude_desktop_config.json中：

• 注意：将“/Users/username”替换为你希望此工具可以访问的路径

与 VS Code 一起使用

为了快速安装，请使用下面的一键安装按钮之一...

如需手动安装，请将以下 JSON 块添加到 VS Code 中的“用户设置 (JSON)”文件中。您可以按下Ctrl + Shift + P并输入Preferences: Open Settings (JSON)来完成此操作。

或者，您可以将其添加到工作区中名为.vscode/mcp.json的文件中。这样您就可以与其他人共享该配置。

请注意.vscode/mcp.json文件中不需要mcp键。

对于 Docker 安装：

与Zed一起使用

添加到您的 Zed settings.json：

调试

您可以使用 MCP 检查器来调试服务器。对于 uvx 安装：

或者，如果您已将软件包安装在特定目录中或正在其上进行开发：

运行tail -n 20 -f ~/Library/Logs/Claude/mcp*.log将显示来自服务器的日志，并可能帮助您调试任何问题。

发展

如果您正在进行本地开发，则有两种方法可以测试您的更改：

1. 运行 MCP 检查器来测试你的更改。请参阅“调试”了解运行说明。
2. 使用 Claude 桌面应用进行测试。将以下内容添加到claude_desktop_config.json中：

Docker

紫外线

建造

Docker 构建：

执照

此 MCP 服务器采用 MIT 许可证。这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。更多详情，请参阅项目仓库中的 LICENSE 文件。