MCP 连接 GitHub/GitLab：代码仓库自动化操作基础

MCP（Model Context Protocol）连接 GitHub 或 GitLab 后，AI Agent 就能直接操作代码仓库：创建 PR、管理 Issue、搜索代码、触发 CI/CD。主机选技术博客里常有人问“MCP 怎么对接代码仓库”“Agent 能不能自动提 PR”，本文直接拆解配置步骤和避坑点，适合 Claude Code、Codex、Hermes Agent 等工具对接仓库自动化场景。

为什么需要 MCP 连接代码仓库？

传统 AI 工具只能通过 API 调用执行单次操作，MCP 提供标准化上下文协议，让 Agent 能持续感知仓库状态、自动执行多步流程。比如：

• Claude Code 读取 Issue 后自动创建分支并提交代码

• Codex 根据对话上下文搜索仓库代码片段

• Hermes Agent 监控 PR 状态并自动合并

核心价值在于：Agent 不再只是“问一句答一句”，而是能像开发者一样操作仓库。

MCP 连接 GitHub/GitLab 的前提条件

不是所有 VPS 都能直接跑起来。先确认环境：

• 一台能访问 GitHub/GitLab 的服务器（建议 2 核 4G 以上，跑 Agent 时内存够用）

• 已安装 Node.js 18+ 或 Python 3.10+（取决于 MCP 客户端实现）

• 拥有 GitHub/GitLab 的 Personal Access Token，权限至少包含 `repo`、`issues`、`pull_requests`

• MCP 客户端（如 Claude Desktop、OpenAI API 的 MCP 适配层，或自建的 n8n 工作流）

获取 API Token

GitHub：Settings → Developer settings → Personal access tokens → Tokens (classic) → 勾选 `repo`、`workflow`、`admin:org`（按需）。生成后复制，别泄露。

GitLab：Preferences → Access Tokens → 选择 `api`、`read_repository`、`write_repository`。Token 只显示一次，立即保存。

配置 MCP 服务器对接仓库

以最常见的 MCP 服务器实现 `@modelcontextprotocol/server-github` 为例（GitLab 有社区版 `server-gitlab`）。安装和配置方式如下：

npm install -g @modelcontextprotocol/server-github

export GITHUB_TOKEN="你的token"
export GITHUB_OWNER="你的用户名或组织名"

然后在 MCP 客户端（如 Claude Desktop 的 `mcp_config.json`）中添加：

json
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_TOKEN": "你的token"
}
}
}
}

GitLab 同理，换成 `@modelcontextprotocol/server-gitlab` 并设置 `GITLAB_TOKEN`、`GITLAB_URL`（自托管需填内网地址）。

测试连接是否成功

启动 MCP 客户端后，发送一个简单查询：

请列出我的仓库列表

正常返回仓库名和描述，说明 MCP 已成功连接。如果返回权限错误，检查 Token 范围；如果超时，检查网络或防火墙是否放行 443 端口。

常见的自动化操作场景

1. 自动创建 Issue 并关联分支

AI Agent 收到用户反馈后，直接调用 MCP 创建 Issue，然后根据 Issue 标题自动创建分支：

MCP 操作：create_issue repo:"owner/repo" title:"修复登录bug" body:"描述"
MCP 操作：create_branch repo:"owner/repo" branch:"fix-login-bug" base:"main"

2. 搜索代码并生成文档

Agent 需要理解项目结构时，调用 `search_code` 方法：

搜索 repo 中所有包含 "API_KEY" 的代码行

MCP 返回文件路径、行号、上下文，Agent 可据此生成安全审计报告。

3. 自动合并已批准的 PR

结合 CI 状态，当 PR 所有检查通过且有至少一个 approve 时，Agent 自动合并：

MCP 操作：list_pull_requests repo:"owner/repo" state:"open"
MCP 操作：merge_pull_request repo:"owner/repo" pr_number:42

老鸟叮嘱：避坑模块

1.Token 权限别给满。只勾选必要 scope，比如只读仓库就只给 `repo:read`，别给 `admin:org`。Token 泄露后风险可控。
2.自托管 GitLab 注意网络。如果 GitLab 在内网，MCP 服务器必须能访问到内网地址。如果 MCP 客户端在公网 VPS，需要反向代理或 VPN。
3.API 限速。GitHub 未认证每小时 60 次，认证后 5000 次。高频率操作（如批量搜索）容易触发限速，建议加上 `wait` 间隔或使用 GraphQL 批量查询。
4.不要用 root 运行 MCP 服务器。创建专用用户 `mcpuser`，Token 只对当前用户可见，避免其他进程读取。
5.日志排查。如果 Agent 报错“Tool not found”，先检查 MCP 服务器是否启动成功：`npx @modelcontextprotocol/server-github –help`。如果返回空，重新安装。

FAQ

Q1：MCP 连接 GitHub 和直接用 GitHub API 有什么区别？
A：MCP 提供标准化协议，Agent 不需要自己写 HTTP 请求、处理认证、解析响应。MCP 服务器封装了常见操作（create_issue、search_code），Agent 只需调用函数名，降低开发成本。

Q2：可以用在 n8n 工作流里吗？
A：可以。n8n 支持自定义 MCP 节点或通过 HTTP 请求调用 MCP 服务器的 API。但 n8n 本身有 GitHub 节点，如果只是简单触发，建议直接用原生节点；需要 Agent 决策时再走 MCP。

Q3：MCP 连接 GitLab 自托管需要额外配置吗？
A：需要设置 `GITLAB_URL` 环境变量指向你的 GitLab 实例地址（如 `https://gitlab.company.com`）。如果使用自签名证书，MCP 服务器可能需要 `NODE_TLS_REJECT_UNAUTHORIZED=0`（仅测试环境）。

Q4：免费版 GitHub 账户能使用 MCP 吗？
A：可以。免费版支持 Personal Access Token，但私有仓库数量有限，且 API 限速更低。企业级自动化建议使用 GitHub Pro 或 Team 版。

Q5：Claude Code 和 Codex 配置 MCP 的步骤一样吗？
A：底层原理相同，都是通过 MCP 客户端加载服务器配置。Claude Desktop 用 `mcp_config.json`，Codex 用 `codex.config.json` 或环境变量。具体路径以官方文档为准。

Q6：MCP 服务器能同时连接 GitHub 和 GitLab 吗？
A：可以。在 MCP 客户端配置文件中添加两个服务器条目，分别命名 `github` 和 `gitlab`，Agent 通过指定工具名调用不同仓库。

MCP 连接代码仓库后，AI Agent 才能真正参与开发流程。从 Issue 创建到 PR 合并，全链路自动化不再是纸上谈兵。配置过程不复杂，关键是把 Token 权限控制好、网络通顺、API 限速考虑进去。跑通一次后，后续扩展其他仓库（Bitbucket、Gitea）原理相同。

—

**相关阅读：**

– [VPS部署AI工具100讲：AI Agent、Codex、Claude Code、Hermes Agent、Ollama与自动化工作流实战教程](https://www.zhujixuan.com/jishujiaocheng/9606.html)
– [n8n VPS 部署教程：搭建自己的自动化工作流平台](https://www.zhujixuan.com/jishujiaocheng/9892.html)
– [AI Agent自动化运维实战100讲：VPS巡检、日志分析、告警处理与工作流教程](https://www.zhujixuan.com/jishujiaocheng/10066.html)