ACORG docs

主题

GitHub MCP ​

GitHub MCP 适合把 GitHub 仓库、Issue、Pull Request、评论和变更记录接入 AI 客户端,用于代码协作和 review。

适用场景 ​

  • 根据 Issue 描述理解需求并生成修改计划。
  • 读取 Pull Request 详情、评论、review 反馈和差异文件。
  • 查询仓库文件、分支、提交和 release 信息。
  • 让 Agent 辅助生成 PR 评论、review 建议或变更摘要。

配置入口 ​

GitHub MCP Server 官方仓库:

https://github.com/github/github-mcp-server

官方同时提供托管的 Remote MCP 和本地 Docker 方式。本文先演示 Codex 连接托管服务；其他客户端请使用官方安装指南,不要把 Codex 的 TOML 片段直接粘贴到 Cursor/Claude Code。

Codex 接入示例 ​

前提:已安装 Codex,并在 GitHub 创建仅包含当前任务所需权限的 Personal Access Token(PAT)。组织仓库可能还需要管理员批准。

GitHub 官方 Codex 安装指南使用以下托管服务地址,并通过环境变量传递 PAT:

powershell
$env:GITHUB_PAT_TOKEN = "<your-github-pat>"
codex mcp add github --url https://api.githubcopilot.com/mcp/ --bearer-token-env-var GITHUB_PAT_TOKEN
codex mcp list

上述 $env: 变量仅在当前 PowerShell 窗口有效。不要在命令历史、项目配置或 Git 仓库中保存真实 Token。若希望跨终端使用,应使用系统密钥管理工具或经批准的用户级环境变量方案。

然后重新启动 Codex,在交互界面中运行 /mcp,确认 github 有可用工具；先做只读查询:

text
只读取并列出我有权访问的仓库名称,不要创建、评论、修改或合并任何内容。

能连接不代表拥有目标仓库的全部权限；如果返回权限错误,先核对 PAT scope 和组织授权,不要直接扩大为全权限 Token。

安全建议 ​

  1. 使用最小权限 Token,不要给过宽的个人访问令牌。
  2. 私有仓库优先使用受控的企业或组织授权。
  3. 涉及创建 Issue、评论 PR、合并 PR 或修改仓库内容时,要求 Agent 先列计划并等待确认。
  4. 明确告诉 Agent 当前任务是只读、评论、review 还是允许写入。

提示词示例 ​

text
请读取这个 PR 的说明、评论和 diff,
总结 reviewer 关注点,并给出需要修改的文件和验证步骤。
只读信息,不要发表评论或修改 PR。

相关页面 ​