Git MCP

基本能力

产品定位

Git MCP 是一个专门用于管理本地 Git 仓库操作的 MCP 服务器，旨在简化 Git 操作的自动化流程。

核心功能

1. 列出仓库：列出所有配置路径下的 Git 仓库。
2. 获取最新标签：查找指定仓库中的最新 Git 标签。
3. 列出提交记录：列出从最新标签到 HEAD 之间的提交记录。
4. 创建标签：在指定仓库中创建新的 Git 标签。
5. 推送标签：将现有标签推送到默认远程仓库。
6. 刷新仓库：通过检出主分支并从所有远程仓库拉取来刷新仓库。

适用场景

1. 自动化版本管理：自动创建和推送 Git 标签。
2. 提交记录管理：查看特定时间段内的提交记录。
3. 仓库维护：自动化刷新和更新本地仓库。

工具列表

1. list_repositories：列出所有 Git 仓库。
2. get_last_git_tag：获取最新 Git 标签。
3. list_commits_since_last_tag：列出从最新标签到 HEAD 的提交记录。
4. create_git_tag：创建新的 Git 标签。
5. push_git_tag：推送 Git 标签到远程仓库。
6. refresh_repository：刷新仓库。

常见问题解答

1. Repository Not Found：确保 GIT_REPOS_PATH 设置正确且仓库存在。
2. No Tags Found：仓库尚未有任何标签。

使用教程

使用依赖

无特殊依赖，需要安装 Git。

安装教程

通过 Smithery 安装

npx -y @smithery/cli install @kjozsa/git-mcp --client claude

手动安装

uvx install git-mcp

配置

将以下 JSON 配置片段添加到您的配置文件中：

{
  "mcpServers": {
    "git-mcp": {
      "command": "uvx",
      "args": ["git-mcp"],
      "env": {
        "GIT_REPOS_PATH": "/path/to/your/git/repositories"
      }
    }
  }
}

调试方式

开发模式

# 安装依赖
uv pip install -r requirements.txt

# 运行开发模式
mcp dev git_mcp/server.py

测试

# 测试 Git 命令功能
python test_git_mcp.py

# 测试 MCP 服务器
python test_mcp_server.py

许可证

None