Git助手MCP
一个为Claude提供Git仓库工具的模型上下文协议(MCP)服务器。
特点/功能
这个MCP提供了以下工具:
- 获取状态 - 获取当前仓库状态(已提交、未提交、未跟踪的文件)
- 列出分支 - 列出所有分支,并突出显示当前分支
- 获取提交历史 - 查看最近的提交,包括提交信息和作者
- 获取分支信息 - 获取当前分支或特定分支的详细信息
- 获取差异 - 显示更改(已提交或未提交)
安装
- 创建虚拟环境并安装依赖项:
python3 -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
pip install -r requirements.txt- 测试服务器:
python server.pyClaude桌面版的配置
将此添加到您的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模式定义工具
- 错误处理
______________________________________________________________________
作为学习项目而构建,配备有 克劳德·科德
