Git仓库管理服务

Q: Git仓库管理服务能用在 Cursor / Cline 吗？

能。MCP 是通用协议，配置在各客户端间基本通用。

一个基于大型语言模型的Git仓库交互与自动化协议服务器，提供读取、搜索和操作Git仓库的工具。

Git仓库管理服务是 modelcontextprotocol 开发的 MCP 服务器：一个基于大型语言模型的Git仓库交互与自动化协议服务器，提供读取、搜索和操作Git仓库的工具。接入两步走：pip install mcp-server-git，再把下文配置粘进客户端 mcpServers 段重启即可。

它是干什么的

Git仓库管理服务做的事可以一句话说清：一个基于大型语言模型的Git仓库交互与自动化协议服务器，提供读取、搜索和操作Git仓库的工具在 MCP 架构里，它负责把这项能力封装成 AI 可调用的工具。

项目	数据
开发者	modelcontextprotocol
Star	89,600
收藏	7
质量等级	A
平台分类	开发效率
部署标签	本地部署、Git自动化、版本控制
仓库	servers

核心能力

本地部署（平台标签）
Git自动化（平台标签）
版本控制（平台标签）

适合谁用

两类人最该装：一是天天在 Claude Desktop、Cursor 里写代码，想让 AI 直接帮你跑命令、改仓库、读文件的人；二是已经在用 MCP 生态、想按需拼装能力的折腾型用户。反过来，如果你只需要偶尔手动用它背后的服务，直接开网页就行，不必上 MCP。

完整安装配置步骤

动手前确认环境齐了：

uv（Python 3.10+）：pip install uv。装完跑一下 uvx --version 确认可用。
Python 3.10+ 与 pip（个别仓库要求 3.11+，以 README 为准）。
Node.js 18 或更高版本（旧版 npx 跑不动一部分新版 MCP 包）。
Docker 环境（docker ps 正常返回即可）。
一个支持 MCP 的客户端：Claude Desktop、Cursor、Cline、Windsurf 任选其一。

第 1 步：安装Git仓库管理服务

终端里任选一条（不同安装方式，效果等价）：

bash

pip install mcp-server-git
npx @modelcontextprotocol/inspector uvx mcp-server-git
npx @modelcontextprotocol/inspector uv run mcp-server-git
docker build -t mcp/git .

第一次用 uvx 启动会现场拉依赖，慢是正常的，别急着 Ctrl+C。

第 2 步：写入 MCP 配置

Claude Desktop 的配置文件路径：macOS 在 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 在 %APPDATA%\Claude\claude_desktop_config.json；Cursor 则是 ~/.cursor/mcp.json（或项目级 .cursor/mcp.json）。把下面这段并进 mcpServers 段（注意是并进外层大括号，别整个文件替换）：

方式 1（任选一份）：

bash

"mcpServers": {
  "git": {
    "command": "uvx",
    "args": ["mcp-server-git", "--repository", "path/to/git/repo"]
  }
}

方式 2（任选一份）：

bash

"mcpServers": {
  "git": {
    "command": "docker",
    "args": ["run", "--rm", "-i", "--mount", "type=bind,src=/Users/username,dst=/Users/username", "mcp/git"]
  }
}

方式 3（pip 安装走这份）：

bash

"mcpServers": {
  "git": {
    "command": "python",
    "args": ["-m", "mcp_server_git", "--repository", "path/to/git/repo"]
  }
}

方式 4（任选一份）：

bash

"context_servers": [
  "mcp-server-git": {
    "command": {
      "path": "uvx",
      "args": ["mcp-server-git"]
    }
  }
],

方式 5（pip 安装走这份）：

bash

"context_servers": {
  "mcp-server-git": {
    "command": {
      "path": "python",
      "args": ["-m", "mcp_server_git"]
    }
  }
},

方式 6（任选一份）：

bash

{
    "command": "uvx",
    "args": ["mcp-server-git", "--repository", "path/to/git/repo"]
}

方式 7（任选一份）：

bash

{
  "git": {
    "command": "docker",
    "args": [
      "run",
      "--rm",
      "-i",
      "--mount",
      "type=bind,src=/Users/username/Desktop,dst=/projects/Desktop",
      "--mount",
      "type=bind,src=/path/to/other/allowed/dir,dst=/projects/other/allowed/dir,ro",
      "--mount",
      "type=bind,src=/path/to/file.txt,dst=/projects/path/to/file.txt",
      "mcp/git"
    ]
  }
}

方式 8（任选一份）：

bash

{
  "git": {
    "command": "uv",
    "args": [
      "--directory",
      "/<path to mcp-servers>/mcp-servers/src/git",
      "run",
      "mcp-server-git"
    ]
  }
}

改完保存。Windows 用户注意：如果 command 写 npx 起不来，换成 npx.cmd 再试。

第 3 步：重启并验证

完全退出客户端再打开（是托盘里真正退出，不是关窗口）。工具列表里出现Git仓库管理服务的工具即接入成功；调用报错的话，先查下面的坑点清单。

容易踩的坑

改了配置没反应：客户端只重启了窗口没退进程。macOS 按 Cmd+Q，Windows 检查托盘。
JSON 报错打不开客户端：多半是最后多个逗号。粘进任何 JSON 校验器里查一遍再保存。
走错了仓库：这个项目的文档在 monorepo 子目录里，Issue 和示例要看子目录的 README，别看主仓库那份。
首次调用超时：uvx 冷启动要装依赖，第一次可能超过客户端默认超时。再调一次，通常第二次就快了。

常见问题

Git仓库管理服务免费吗？

代码在 GitHub（https://github.com/modelcontextprotocol/servers/tree/main/src/git）开放获取。个别功能依赖第三方服务时费用另算，看仓库 LICENSE 和定价页。

Git仓库管理服务能用在 Cursor / Cline 吗？

能。MCP 是通用协议，同一份 mcpServers 配置在这些客户端之间基本通用，只是配置文件位置不同。

需要外网或代理吗？

拉包和调用官方 API 需要能访问 GitHub 与对应服务域名，内网环境先测 git ls-remote 和接口连通性。