Git仓库工具服务

Git助手MCP

一个为Claude提供Git仓库工具的模型上下文协议（MCP）服务器。

特点/功能

这个MCP提供了以下工具：

• 获取状态 - 获取当前仓库状态（已提交、未提交、未跟踪的文件）
• 列出分支 - 列出所有分支，并突出显示当前分支
• 获取提交历史 - 查看最近的提交，包括提交信息和作者
• 获取分支信息 - 获取当前分支或特定分支的详细信息
• 获取差异 - 显示更改（已提交或未提交）

安装

1. 创建虚拟环境并安装依赖项：

   复制

   python3 -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   pip install -r requirements.txt
   

2. 测试服务器：

   复制

   python server.py
   

Claude桌面版的配置

将此添加到您的Claude Desktop MCP设置文件中：

macOS（发音为“Mac OS”，中文常译为“苹果电脑操作系统”或简称为“苹果系统”）： ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "git-helper": {
      "command": "/Users/prateek/Code/claude/git-helper-mcp/venv/bin/python",
      "args": ["/Users/prateek/Code/claude/git-helper-mcp/server.py"]
    }
  }
}

添加后，重启Claude桌面版。

使用示例

配置完成后，您可以向Claude询问诸如：

• “我的Git仓库状态如何？”
• “显示最近的提交历史”
• “列出所有分支”
• “我在哪个分支上？”
• “显示未暂存的更改”
• “我的暂存区里有什么？”

其工作原理

MCP服务器作为一个独立的进程运行，并通过标准输入输出（stdio）与Claude进行通信。当你提出与Git相关的问题时，Claude可以调用这些工具，从你的Git仓库中获取实时信息。

要求

• Python 3.10+（Python 3.10及以上版本）
• Git 已安装并添加到系统路径中
• MCP Python SDK（MCP Python软件开发工具包）

学习要点

这个项目展示了：

• 构建一个MCP服务器
• 子进程执行
• 异步Python
• 使用JSON模式定义工具
• 错误处理

作为学习项目而构建，配备有 克劳德·科德