Git MCP

用于管理本地仓库 Git 操作的 MCP 服务器。

安装

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 Git MCP，请执行以下操作：

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

手动安装

uvx install git-mcp

配置

使用以下 JSON 配置代码段添加 MCP 服务器：

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

功能和用法

环境变量

• GIT_REPOS_PATH: 包含 Git 仓库的目录路径（必需）

您可以在您的环境中设置此变量，或者在运行服务器的目录中创建一个 .env 文件。

可用方法

list_repositories

列出配置路径中的所有 Git 仓库。

• 参数：无
• 返回值：仓库名称列表

get_last_git_tag

查找指定仓库中的最后一个 Git 标签。

• 参数：repo_name（Git 仓库的名称）
• 返回值：包含 version（标签名称）和 date（标签创建日期）的字典

list_commits_since_last_tag

列出最后一个 Git 标签和 HEAD 之间的提交消息。

• 参数：
  • repo_name：Git 仓库的名称
  • max_count（可选）：要返回的最大提交数量
• 返回值：包含 hash、author、date 和 message 的字典列表

create_git_tag

在指定的仓库中创建一个新的 git 标签。

• 参数：
  • repo_name：git 仓库的名称
  • tag_name：要创建的标签的名称
  • message（可选）：带注释标签的消息（如果未提供，则创建轻量级标签）
• 返回值：包含 status、version（标签名称）、date（标签创建日期）和 type（带注释或轻量级）的字典

push_git_tag

将现有的 git 标签推送到默认的远程仓库。

• 参数：
  • repo_name：git 仓库的名称
  • tag_name：要推送的标签的名称
• 返回值：包含 status、remote（远程仓库的名称）、tag（标签的名称）和 message（成功消息）的字典

refresh_repository

通过检出主分支（或备用分支 master）并从所有远程仓库拉取来刷新仓库。

• 参数：
  • repo_name：git 仓库的名称
• 返回值：包含 status、repository、branch 和 pull_results（每个远程仓库的结果）的字典

故障排除

• Repository Not Found（仓库未找到）：确保 GIT_REPOS_PATH 设置正确并且仓库存在
• No Tags Found（未找到标签）：仓库还没有任何标签

开发

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

# 在带有 Inspector 的开发模式下运行
mcp dev git_mcp/server.py

测试

该项目包含两个测试脚本：

1. test_git_mcp.py - 直接测试底层 Git 命令功能，而不使用 MCP 服务器。
2. test_mcp_server.py - 通过启动服务器实例并对其进行调用来测试 MCP 服务器功能。

要运行测试：

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

# 测试 MCP 服务器（需要安装 git-mcp 包）
python test_mcp_server.py