Git MCP Server

一个为大型语言模型提供全面 Git 功能的 Model Context Protocol (MCP) 服务器，通过安全标准化接口执行版本控制操作。

安装

# 1. 克隆仓库
git clone https://github.com/cyanheads/git-mcp-server.git

# 2. 导航到项目目录
cd git-mcp-server

# 3. 安装依赖项
npm install

# 4. 构建项目
npm run build

配置

在 MCP 客户端中添加服务器配置：

{
  "mcpServers": {
    "git": {
      "command": "node",
      "args": ["/path/to/git-mcp-server/build/index.js"],
      "env": {
        "GIT_DEFAULT_PATH": "/optional/default/path/for/git/operations"
      }
    }
  }
}

注意: 所有路径必须是绝对路径，例如 /Users/username/projects/my-repo

核心功能

• 基础 Git 操作：初始化、克隆、提交、推送
• 分支管理：创建、列表、删除、检出
• 远程操作：添加、删除、推送、拉取
• 批量操作：按序执行多个 Git 命令
• 安全特性：路径验证、状态检查、错误处理

常用命令示例

初始化仓库

{
  "path": "/path/to/repository"
}

克隆仓库

{
  "url": "https://github.com/username/repo.git",
  "path": "/path/to/destination"
}

批量操作（推荐）

{
  "path": "/path/to/repository",
  "actions": [
    {
      "type": "stage",
      "files": ["file1.txt", "file2.js"]
    },
    {
      "type": "commit",
      "message": "Add new features"
    },
    {
      "type": "push",
      "branch": "main"
    }
  ]
}

最佳实践

• 使用 bulk_action 执行多步操作
• 始终使用绝对路径
• 提供清晰的提交信息
• 操作前检查仓库状态

开发

# 监视文件变化
npm run watch

# 运行 MCP 检查器
npm run inspector

更多详细信息请参考完整文档或贡献指南。

---

使用 Model Context Protocol 构建