GitCafe MCP Server

什么是 GitCafe MCP Server？

GitCafe MCP Server 是 GitCafe 官方托管的端点（https://git.cafe/mcp），让 Claude、ChatGPT 等 AI 客户端读取代码仓库，并在你授权后处理 issue、pull request 和代码评审。

GitCafe 是一个 Git 托管与代码评审服务，支持堆叠式 pull request、可选的 GitHub 双向同步以及 cafe CLI。GitCafe MCP Server 由 GitCafe 自己运营。公开仓库无需登录即可读取；通过 OAuth 登录后可访问私有仓库并使用写入类工具，权限仅限于你批准的仓库和权限。

如何使用 GitCafe MCP Server？

该服务器使用 Streamable HTTP 传输，地址为：

https://git.cafe/mcp

读取类工具可以匿名用于公开仓库。写入类工具和 get_me 会触发登录：客户端打开浏览器，你用已验证的 GitCafe 账号登录，选择最多 50 个仓库，检查权限（读取默认开启，写入和管理默认关闭），然后点击 Approve connection。GitCafe 文档提醒：不要把 token 或密码粘贴到连接器设置中，登录由浏览器流程完成。

Claude Code

claude mcp add --transport http gitcafe https://git.cafe/mcp

需要访问私有仓库或写入权限时，在 Claude Code 中运行 /mcp 完成登录。

Claude Desktop / claude.ai

打开 Customize → Connectors → Add → Add custom connector，填写名称和 https://git.cafe/mcp，保留自动检测到的登录和自动注册选项，然后选择 Add → Connect 并批准连接。GitCafe 建议把工具保持为 Needs approval，以便逐次审核调用。

Cursor

将服务器添加到 ~/.cursor/mcp.json（或项目内的 .cursor/mcp.json）：

{
  "mcpServers": {
    "gitcafe": {
      "url": "https://git.cafe/mcp"
    }
  }
}

VS Code

添加到 .vscode/mcp.json：

{
  "servers": {
    "gitcafe": {
      "type": "http",
      "url": "https://git.cafe/mcp"
    }
  }
}

GitCafe 也提供了 ChatGPT 的配置说明：开启开发者模式后，用该 URL 创建一个 MCP 应用，并保持 OAuth。

GitCafe MCP Server 的主要功能

• 官方服务，由 GitCafe 托管，本地无需运行任何程序。
• 匿名读取公开仓库：代码、分支和标签、issue、pull request、评审和 CI 结果。
• OAuth 连接仅限你选择的仓库（最多 50 个）和授予的权限；写入和管理权限默认关闭。
• 完整的 pull request 工作流：读取 diff、行内评论、提交评审、解决讨论线程以及合并（合并需要 pr:merge:write 权限）。
• issue 管理：创建、编辑、关闭、重新打开和评论。
• 通过 Buildkite 的运行、检查、任务和日志末尾查看 CI 状态。
• 每个操作都受仓库规则约束，应用不能推送提交、创建分支、启动 CI 或删除仓库。
• 连接有效期 30 天，可随时在 Settings → Authorized Apps 中撤销。

GitCafe MCP Server 工具

我们对该端点的探测返回了 21 个工具：

• 身份与仓库：get_me 显示连接所代表的身份及可访问范围；list_repositories 和 get_repository 用于查找仓库及其默认分支。
• 代码：list_refs、list_tree、read_file 和 search_code 浏览分支、标签、目录和文件，并可在任意 ref 上进行字面字符串搜索。
• Issue：list_issues、issue_read、create_issue 和 update_issue。
• Pull request：list_pull_requests、pull_request_read、get_pull_request_diff、create_pull_request、update_pull_request、submit_review 和 merge_pull_request。
• 评论：add_comment 可在 issue、pull request 会话或 diff 行内发表评论；update_comment 用于编辑评论和解决讨论线程。
• CI：ci_read 读取 Buildkite 的运行、检查、任务和日志。

写入类工具需要传入预期版本号，因此过期的写入会失败，而不会覆盖他人的修改。merge_pull_request 可能在合并完成前返回 accepted，智能体应持续检查直到状态变为 completed。

GitCafe MCP Server 的使用场景

• 探索陌生的公开仓库：“找到这个仓库里的重试逻辑在哪里，并解释它。”
• 评审 pull request：“读取 PR 42 的 diff，对有风险的改动留下行内评论，如果缺少测试就请求修改。”
• 分拣 issue：“列出提到 login 的未关闭 issue，并给重复的打上标签。”
• 检查 CI：“这个 pull request 最近一次运行为什么失败？显示失败任务日志的末尾。”
• 合并堆叠 PR：“在当前 head 上批准 PR 18，检查通过后合并。”

GitCafe MCP Server 常见问题排查

• 看不到私有仓库：匿名访问只覆盖公开仓库，连接也只覆盖你选择的仓库。连接之后新建的仓库不会自动包含，需要重新连接来添加。
• 一个月后工具失效：连接有效期为 30 天，请在客户端中重新连接。
• REST API token 被拒绝：REST API 和 MCP 的 token 相互独立、不能混用。请通过 MCP 登录流程连接 MCP 服务器。
• 触发速率限制：已登录的 MCP 请求计入账号的 API 额度（每 60 秒 1,000 次，按套餐倍增）；匿名请求每个地址每小时限 1,200 次。