mcp-server-git: A git MCP server

mcp-server-git: A git MCP server

site icon
2025.04.20 73000
JavaScriptGit 自动化版本控制工具开发效率
Git MCP 通过大型语言模型提供读取、搜索和操作 Git 仓库的工具。该服务器目前处于早期开发阶段,功能和可用工具可能会随着开发进展而变化和扩展。
View on GitHub

Overview

基本能力

产品定位

mcp-server-git 是一个专门用于 Git 仓库交互和自动化的 MCP 服务器,旨在通过大型语言模型简化 Git 操作流程。

核心功能

  • 提供多种 Git 操作工具,包括状态查看、差异比较、提交、分支管理等
  • 支持通过大型语言模型进行 Git 仓库交互
  • 提供多种安装和运行方式(uv、pip、docker)

适用场景

  • 开发者希望通过自然语言命令操作 Git 仓库
  • 需要自动化 Git 工作流的场景
  • 集成 Git 功能到其他开发工具中

工具列表

  1. git_status - 显示工作树状态
  2. git_diff_unstaged - 显示未暂存的更改
  3. git_diff_staged - 显示已暂存的更改
  4. git_diff - 显示分支或提交间的差异
  5. git_commit - 提交更改到仓库
  6. git_add - 添加文件到暂存区
  7. git_reset - 取消所有暂存的更改
  8. git_log - 显示提交日志
  9. git_create_branch - 创建新分支
  10. git_checkout - 切换分支
  11. git_show - 显示提交内容
  12. git_init - 初始化 Git 仓库

常见问题解答

  • 可通过 MCP inspector 调试服务器
  • 日志文件位于 ~/Library/Logs/Claude/mcp*.log
  • 开发时可通过 Claude 桌面应用测试更改

使用教程

使用依赖

  • 需要安装 Python 环境
  • 可选安装 uv 或 docker

安装教程

  1. 使用 pip 安装:
pip install mcp-server-git
  1. 运行服务:
python -m mcp_server_git
  1. 使用 docker 安装:
cd src/git
docker build -t mcp/git .

调试方式

  1. 使用 MCP inspector 调试:
npx @modelcontextprotocol/inspector uvx mcp-server-git
  1. 查看日志:
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。