Git MCP 服务器

用于 Git 操作的模型上下文协议 (MCP) 服务器，为像 Claude Desktop 这样的 MCP 客户端提供全面的 Git 功能。

特性

• 上下文感知：根据工作目录自动检测当前项目
• 全面的 Git 操作：状态、分支、差异、日志、文件内容、提交等
• 多项目支持：在不同的项目目录之间无缝工作
• 错误处理：适当的 MCP 错误响应
• 分支管理：创建、切换和管理分支
• 远程操作：从远程仓库推送、拉取和获取

安装

选项 1：全局安装（推荐）

npm install -g git-mcp-server

选项 2：本地开发设置

1. 克隆并安装：

   git clone https://github.com/yourusername/git-mcp-server.git
   cd git-mcp-server
   npm install
   

2. 构建项目：

   npm run build
   

配置

Claude Desktop

将此服务器添加到您的 Claude Desktop 配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "git": {
      "command": "git-mcp-server",
      "args": []
    }
  }
}

其他 MCP 客户端

对于其他 MCP 客户端，直接使用服务器二进制文件：

git-mcp-server

服务器将自动使用当前工作目录作为 Git 仓库上下文。

使用

配置完成后，您可以通过您的 MCP 客户端使用 Git 操作。服务器会自动检测当前工作目录中的 Git 仓库。

示例命令

让您的 MCP 客户端（如 Claude）执行 Git 操作：

• "当前的 git 状态是什么？"
• "显示与主分支的差异"
• "创建一个名为 feature/new-feature 的新分支"
• "用消息 '修复解析器中的错误' 提交这些更改"
• "将当前分支推送到 origin"

测试服务器

您可以手动从任何 Git 仓库测试服务器：

cd /path/to/your/git/repo
git-mcp-server

可用工具

仓库信息

• git_status - 获取当前 git 状态
• git_current_branch - 获取当前分支名称
• git_staged_changes - 获取暂存更改
• git_working_directory - 获取当前工作目录信息

文件和历史操作

• git_diff - 显示分支/提交之间的差异
• git_log- 获取提交历史
• git_show_file - 显示特定提交处的文件内容

分支操作

• git_branches - 列出所有分支
• git_checkout - 切换到不同分支或创建新分支

暂存和提交操作

• git_add - 将文件添加到暂存区
• git_commit - 创建带有消息和文件的提交

远程操作

• git_pull - 从远程仓库拉取更改
• git_fetch - 从远程仓库获取更改而不合并

仓库管理

• git_init - 初始化一个新的 git 仓库

前提条件

• Node.js 18+
• npm 或 yarn
• 系统上已安装 Git

贡献

1. 分叉仓库
2. 创建功能分支
3. 进行更改
4. 如适用，请添加测试
5. 提交拉取请求

许可证

MIT 许可证 - 详情见 LICENSE 文件。

项目结构

git-mcp-server/
├── package.json          # 项目依赖和脚本
├── tsconfig.json         # TypeScript 配置
├── src/
│   └── index.ts         # 主服务器实现
├── build/
│   └── index.js         # 编译的 JavaScript（生成）
└── README.md            # 此文件

开发

• npm run build - 构建 TypeScript 代码
• npm run dev - 开发监视模式
• npm start - 运行构建的服务器 </中文翻译>