Git MCP

👁 铁匠徽章
MCP 服务器用于管理本地存储库上的 Git 操作。

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 Git MCP：

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

手动安装

uvx install git-mcp

Related MCP server: MCP Git Server

配置

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

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

特点和用途

环境变量

• GIT_REPOS_PATH ：包含 Git 存储库的目录的路径（必需）

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

可用方法

列出存储库

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

• 参数：无

• 返回：存储库名称列表

获取最后一个 git 标签

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

• 参数： repo_name （Git 存储库的名称）

• 返回：带有version （标签名称）和date （标签创建日期）的字典

list_commits_since_last_tag

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

• 参数：

  • repo_name ：Git 存储库的名称

  • max_count （可选）：返回的最大提交数

• 返回：包含hash 、 author 、 date和message字典列表

创建 git 标签

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

• 参数：

  • repo_name ：git 存储库的名称

  • tag_name ：要创建的标签的名称

  • message （可选）：注释标签的消息（如果未提供，则创建轻量级标签）

• 返回：包含status 、 version （标签名称）、 date （标签创建日期）和type （带注释或轻量级）的字典

推送_git_标签

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

• 参数：

  • repo_name ：git 存储库的名称

  • tag_name ：要推送的标签名称

• 返回：包含status 、 remote （远程名称）、 tag （标签名称）和message （成功消息）的字典

刷新存储库

通过检出主分支（或主分支作为后备）并从所有远程拉取来刷新存储库。

• 参数：

  • repo_name ：git 存储库的名称

• 返回：包含status 、 repository 、 branch和pull_results （每个远程的结果）的字典

故障排除

• 未找到存储库：确保GIT_REPOS_PATH设置正确且存储库存在

• 未找到标签：存储库尚无任何标签

发展

# Install dependencies
uv pip install -r requirements.txt

# Run in dev mode with Inspector
mcp dev git_mcp/server.py

测试

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

1. test_git_mcp.py - 直接测试底层 Git 命令功能，无需使用 MCP 服务器。

2. test_mcp_server.py - 通过启动服务器实例并对其进行调用来测试 MCP 服务器功能。

运行测试：

# Test the Git command functionality
python test_git_mcp.py

# Test the MCP server (requires the git-mcp package to be installed)
python test_mcp_server.py

Maintenance

Resources

• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• create_git_tagB
• get_last_git_tagA
• list_commits_since_last_tagB
• list_repositoriesB
• push_git_tagB
• refresh_repositoryB