Git MCP Server Rust

Git MCP Server (Rust)

一个高性能的 Rust 版 Git MCP Server，为 AI 代理提供完整的 Git 操作能力。

特性

• 28 个 Git 工具 - 覆盖所有常用 Git 操作 + changelog 分析 + wrap-up 指令
• STDIO / HTTP 传输 - 支持 STDIO 与 streamable-http 风格单端点
• 会话工作目录 - 支持动态切换项目目录
• MCP Resources / Prompts - 支持 resources/list|read 与 prompts/list|get
• 安全路径验证 - 可配置的基础目录限制
• 高性能 - Rust 实现，单二进制部署

安装

方式一：从源码构建

# 克隆仓库
git clone https://github.com/QiuZH001/git-mcp-server-rust.git
cd git-mcp-server-rust

# 构建 release 版本
cargo build --release

# 二进制文件位置
./target/release/git-mcp-server

方式二：直接下载

# 下载预编译二进制（如果可用）
# 或复制已编译的二进制到任意位置
cp ./target/release/git-mcp-server /usr/local/bin/

前置要求

• Rust 1.70+（仅从源码构建时需要）
• Git 2.0+
• 系统：macOS / Linux / Windows

配置

环境变量

MCP 客户端配置

Claude Code

编辑 ~/.claude/claude_desktop_config.json：

{
  "mcpServers": {
    "git": {
      "command": "/path/to/git-mcp-server",
      "env": {
        "GIT_BASE_DIR": "/Users/yourname/projects",
        "GIT_USERNAME": "Your Name",
        "GIT_EMAIL": "your@email.com"
      }
    }
  }
}

Cursor

编辑 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "git": {
      "command": "/path/to/git-mcp-server",
      "env": {
        "GIT_BASE_DIR": "/Users/yourname/projects"
      }
    }
  }
}

Windsurf

编辑 Windsurf 配置文件：

{
  "mcpServers": {
    "git": {
      "command": "/path/to/git-mcp-server",
      "args": [],
      "env": {
        "GIT_BASE_DIR": "/home/user/code"
      }
    }
  }
}

OpenCode

编辑 opencode MCP 配置：

{
  "mcpServers": {
    "git": {
      "command": "/path/to/git-mcp-server",
      "env": {
        "GIT_BASE_DIR": "/path/to/your/projects",
        "MCP_LOG_LEVEL": "debug"
      }
    }
  }
}

工具列表

仓库管理

暂存与提交

历史查询

分支操作

远程操作

高级操作

MCP 方法

支持以下 MCP / JSON-RPC 方法：

• initialize
• tools/list
• tools/call
• resources/list
• resources/read
• prompts/list
• prompts/get

Resources

• git://working-directory：返回当前会话工作目录

Prompts

• git_wrapup：Git 收尾工作流提示词模板（支持参数）

使用示例

示例 1：初始化并提交

AI: 帮我在 /projects/my-app 初始化一个 git 仓库并做第一次提交

1. 使用 git_init 初始化仓库
2. 使用 git_add 添加所有文件
3. 使用 git_commit 创建初始提交

示例 2：查看项目状态

AI: 查看当前项目的 git 状态

使用 git_status 查看分支、暂存文件、未跟踪文件等

示例 3：创建功能分支

AI: 创建一个名为 feature/login 的分支并切换过去

1. git_branch 创建分支
2. git_checkout 切换分支

示例 4：查看提交历史

AI: 查看最近 10 条提交记录

使用 git_log 并设置 max_count=10

示例 5：推送代码

AI: 将当前分支推送到 origin

使用 git_push，设置 remote=origin, branch=当前分支

工作目录管理

设置工作目录

在执行任何 Git 操作前，建议先设置工作目录：

使用 git_set_working_dir 设置项目路径
参数: { "path": "/path/to/your/project" }

清除工作目录

使用 git_clear_working_dir 清除会话中的工作目录设置
参数: { "confirm": "Y" }

安全特性

路径限制

设置 GIT_BASE_DIR 后，所有操作将被限制在该目录及其子目录内：

{
  "env": {
    "GIT_BASE_DIR": "/Users/you/safe-projects"
  }
}

尝试访问 GIT_BASE_DIR 外的路径将返回错误。

危险操作确认

以下操作需要明确确认：

• git_reset (hard 模式) - 需要 confirmed: true
• git_clean - 需要 force: true
• git_push --force - 需要 force: true

故障排除

常见问题

Q: 服务器启动后无响应

确保使用 STDIO 传输模式，检查日志输出：

MCP_LOG_LEVEL=debug ./git-mcp-server

Q: Git 操作失败 "command not found"

确保系统已安装 Git 并在 PATH 中：

which git

Q: 权限被拒绝

检查 GIT_BASE_DIR 配置和文件系统权限。

Q: 中文文件名乱码

确保系统 locale 设置正确：

export LANG=en_US.UTF-8

调试模式

启用详细日志：

{
  "env": {
    "MCP_LOG_LEVEL": "debug"
  }
}

开发

运行测试

# 运行所有测试
cargo test

# 运行单个测试
cargo test test_git_status

# 带输出运行
cargo test -- --nocapture

代码检查

cargo clippy
cargo fmt -- --check

与 TypeScript 版本对比

许可证

Apache-2.0

相关链接

• MCP 协议规范
• 原 TypeScript 版本