Git MCP 服务器

一个模型上下文协议 (MCP) 服务器，通过标准化的接口提供增强的 Git 操作。此服务器与 MCP 生态系统集成，为 AI 助手提供 Git 功能。

功能

• 核心 Git 操作: init, clone, status, add, commit, push, pull
• 分支管理: list, create, delete, checkout
• 标签操作: list, create, delete
• 远程管理: list, add, remove
• 暂存操作: list, save, pop
• 批量操作: 顺序执行多个 Git 操作
• GitHub 集成: 通过个人访问令牌内置 GitHub 支持
• 路径解析: 智能路径处理，带有可选的默认路径配置
• 错误处理: 具有自定义错误类型的全面错误处理
• 仓库缓存: 高效的仓库状态管理
• 性能监控: 内置性能跟踪

安装

1. 克隆仓库:

git clone https://github.com/yourusername/git-mcp-v2.git
cd git-mcp-v2

2. 安装依赖:

npm install

3. 构建项目:

npm run build

配置

添加到您的 MCP 配置文件:

{
  "mcpServers": {
    "git-v2": {
      "command": "node",
      "args": ["path/to/git-mcp-v2/build/index.js"],
      "env": {
        "GIT_DEFAULT_PATH": "/path/to/default/git/directory",
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-github-pat"
      }
    }
  }
}

环境变量

• GIT_DEFAULT_PATH: (可选) Git 操作的默认路径
• GITHUB_PERSONAL_ACCESS_TOKEN: (可选) 用于 GitHub 操作的 GitHub 个人访问令牌

可用工具

基本操作

• init: 初始化一个新的 Git 仓库
• clone: 克隆一个仓库
• status: 获取仓库状态
• add: 暂存文件
• commit: 创建一个提交
• push: 将提交推送到远程仓库
• pull: 从远程仓库拉取更改

分支操作

• branch_list: 列出所有分支
• branch_create: 创建一个新的分支
• branch_delete: 删除一个分支
• checkout: 切换分支或恢复工作树文件

标签操作

• tag_list: 列出标签
• tag_create: 创建一个标签
• tag_delete: 删除一个标签

远程操作

• remote_list: 列出远程仓库
• remote_add: 添加一个远程仓库
• remote_remove: 移除一个远程仓库

暂存操作

• stash_list: 列出暂存
• stash_save: 保存更改到暂存
• stash_pop: 应用并移除一个暂存

批量操作

• bulk_action: 顺序执行多个 Git 操作

开发

# 运行测试
npm test

# 运行带有覆盖率的测试
npm run test:coverage

# 运行 linter
npm run lint

# 格式化代码
npm run format

许可证

MIT

贡献

1. Fork 仓库
2. 创建您的特性分支 (git checkout -b feature/amazing-feature)
3. 提交您的更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request