Git操作协议服务器

Git MCP服务器

一个全面的模型上下文协议（MCP）服务器，通过标准化的接口提供Git操作。该服务器使AI助手能够以编程方式与Git存储库进行交互。

特性

• 完成Git操作：状态、日志、分支管理、提交操作
• 远程存储库管理：克隆、推送、拉取、远程配置
• Git高级功能：停滞、标签管理、重置操作、差异查看
• 工作目录控制：在任何Git存储库路径上操作
• 类型安全实施：使用TypeScript构建以提高可靠性

安装

1. 克隆或下载此存储库
2. 安装依赖项：
   复制

   npm install
   

3. 构建TypeScript代码：
   复制

   npm run build
   

4. 启动服务器：
   复制

   npm start
   

可用工具

存储库状态

• git_status -获取存储库的git状态
• git_log -显示具有可配置格式的提交历史记录
• git_branch -列出所有分支（本地和远程）
• git_diff -显示提交或工作树之间的更改

分期和提交

• git_add -提交阶段文件（特定文件或所有更改）
• git_commit -使用消息创建新提交
• git_stash -临时保存/应用/删除更改

库管理

• git_init -初始化新存储库
• git_clone -克隆远程存储库
• git_push -将提交推送到远程分支
• git_pull -从远程获取并合并更改
• git_remote -添加/删除/重命名远程存储库
• git_reset -将当前HEAD重置为指定状态
• git_tag -创建/删除/列出标签

用法示例

检查存储库状态

{
  "tool": "git_status",
  "arguments": {
    "cwd": "/path/to/repository"
  }
}

创建提交

{
  "tool": "git_commit",
  "arguments": {
    "message": "Add new feature implementation",
    "cwd": "/path/to/repository"
  }
}

克隆存储库

{
  "tool": "git_clone",
  "arguments": {
    "url": "https://github.com/user/repo.git",
    "cwd": "/local/path",
    "depth": 1
  }
}

配置

服务器会自动检测当前工作目录，但允许为存储库操作指定替代路径。

需求

• Node.js 18+（支持ES模块）
• Git已安装并在PATH中可用
• TypeScript 5.0+（用于构建）

发展

对于自动重建的开发模式：

npm run dev

许可证

MIT许可证-您可以在项目中自由使用。