GIT MCP Server

GIT MCP Server

site icon
2025.04.03 36
TypeScriptGit 仓库管理开发工具开发效率
git-mcp-server 是一个基于 Model Context Protocol (MCP) 的服务器,专门用于与 Git 仓库进行交互。它允许 AI 助手和 LLM 代理通过标准化接口管理仓库、分支、提交和文件,而无需直接访问文件系统或命令行。该服务器将 Git 操作作为 MCP 资源和工具公开,利用 `simple-git` 库实现核心功能,同时保持适当的安全边界。
View on GitHub

Overview

基本能力

产品定位

git-mcp-server 是一个 Git 仓库管理工具,通过 MCP 协议提供标准化的 Git 操作接口,适用于 AI 助手和自动化脚本。

核心功能

  • 仓库管理:初始化、克隆和检查仓库状态
  • 分支操作:创建、列出、检出、删除和合并分支
  • 工作目录操作:暂存文件、提交更改、创建差异
  • 远程操作:添加远程仓库、拉取、推送
  • 高级 Git 命令:管理标签、暂存更改、拣选提交、变基

适用场景

  • AI 助手自动化管理 Git 仓库
  • 开发工具集成 Git 操作
  • 自动化脚本执行 Git 命令

工具列表

  • 仓库操作工具git_init, git_clone, git_status
  • 分支操作工具git_branch_list, git_branch_create, git_checkout, git_branch_delete, git_merge
  • 工作目录操作工具git_add, git_reset, git_commit, git_diff_unstaged, git_diff_staged, git_reset_commit, git_clean
  • 远程操作工具git_remote_add, git_remote_list, git_fetch, git_pull, git_push
  • 高级操作工具git_tag_create, git_tag_list, git_stash_create, git_stash_list, git_stash_apply, git_stash_pop, git_cherry_pick, git_rebase, git_log, git_show

常见问题解答

  • 如何安装:通过 NPM 全局安装或从源代码构建
  • 如何运行:使用 git-mcp-server 命令或直接运行构建后的脚本
  • 如何集成:通过 MCP 客户端配置文件添加服务器信息

使用教程

使用依赖

  • Node.js 16 或更高版本
  • Git 已安装并可在 PATH 中访问

安装教程

从 NPM 安装

npm install -g @cyanheads/git-mcp-server

从源代码安装

git clone https://github.com/cyanheads/git-mcp-server.git
cd git-mcp-server
npm install
npm run build

调试方式

运行服务器

git-mcp-server

node build/index.js

使用 MCP 检查器测试

npx @modelcontextprotocol/inspector git-mcp-server

npx @modelcontextprotocol/inspector build/index.js

许可证

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