GitHub MCP 服务器
GitHub 官方 MCP 服务器:让 AI Agent 读写仓库、管理 Issue 与 PR、操作 Actions。
安装
传输方式: both
claude mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN=<your-token> -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server
工具列表 (8)
context
Context about the current user and GitHub session
repos
Browse repositories, read files, search code and inspect commits
issues
Create, read, comment on and manage GitHub issues
pull_requests
Create, review and manage pull requests
users
Look up users, organisations and profiles
actions
Trigger and inspect GitHub Actions workflows and runs
code_security
Code scanning alerts and security advisories
search
Search repositories, code, issues and users across GitHub
GitHub MCP 服务器评测:让 AI Agent 直接操作 GitHub
大多数 AI 编程助手只能读你磁盘上的代码,一旦工作离开本机就束手无策。它们打不开 Pull Request、整理不了 Issue 列表、查不了 CI 是否通过,也找不到从未克隆过的仓库里的文件。对话在本地检出之外就停住了,你成了 Agent 与 GitHub 之间复制粘贴的桥梁。
GitHub MCP 服务器是 GitHub 官方的 MCP 服务器,它填上了这个缺口。它把 Claude、Cursor、VS Code、Windsurf 等 MCP 客户端直接连到 GitHub 平台,让 Agent 用自然语言浏览仓库、阅读代码、管理 Issue 与 PR、查看 Actions 运行状态。2026 年 11 月发布的 2.1.0 是目前最新版,也是 MCP 生态中安装量最大、维护最活跃的 GitHub 集成。
什么是 GitHub MCP 服务器?
GitHub MCP 服务器是由 GitHub 自己维护的模型上下文协议服务器,有两种形态:托管在 api.githubcopilot.com/mcp 的远程服务器,一键连接并用 GitHub OAuth 登录;以及本地服务器,以 Docker 镜像(ghcr.io/github/github-mcp-server)形式运行在你的机器上,用个人访问令牌认证。两种形态能力相同,远程版上手最快,本地版适合企业版服务器与离线环境。
它的工具按工具集组织。默认工具集覆盖上下文、仓库、Issue、PR 与用户,还可以按需加上 Actions、代码安全、讨论、Gist、搜索与通知,或用 all 工具集全部启用。因为是官方出品,它紧跟 GitHub API 的更新,支持 GitHub 企业云,安全修复也发得很快。
核心功能
1. 官方出品,持续维护
这不是社区封装,而是 GitHub 亲自开发和发布的产品,GitHub 上有 3.4 万星,2026 年 11 月发布了 2.1.0 版,还有专门的安全政策。GitHub API 一出新能力,这里最先跟上。
2. 远程服务器,一键连接
托管的远程服务器不需要 Docker,不用管令牌,也不用在本地跑进程。在 VS Code、Claude Desktop 或 Cursor 里连接,用 GitHub OAuth 登录,Agent 马上就能操作你有权访问的任何仓库。
3. 完整的仓库与代码访问
Agent 可以浏览仓库目录、读取文件内容、跨仓库搜索代码、查看提交与对比分支。“重试逻辑写在哪”这类问题,Agent 可以直接从真实代码库里回答,而不是凭你对代码的记忆。
4. Issue 与 PR 全流程
根据 Bug 报告创建 Issue、总结冗长的讨论串、从本地分支发起 PR、查看差异并要求修改。Agent 操作的就是团队平时用的那些对象,不会在转述中丢失信息。
5. 工具集控制上下文体积
不必一次注册所有工具,只启用需要的工具集:整理 Issue 时只要 repos 与 issues,审查 CI 时再加 actions 与 code security。工具越少,模型选工具越快,提示词越短,Token 花费越低。
工作原理
远程版通过流式 HTTP 讲 MCP 协议,本地版通过 stdio。客户端用 OAuth(远程)或个人访问令牌(本地)认证,服务器把工具调用翻译成 GitHub API 请求。还有只读模式,适合那些你只想让 Agent 看、不想让它写的场景。
在 Claude Code 里安装本地服务器,执行:
claude mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN=你的令牌 -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server
在 VS Code、Cursor 或 Claude Desktop 里,用下面这个地址添加远程服务器,再用 GitHub 登录:
https://api.githubcopilot.com/mcp/
想限制工具范围,可以设置 GITHUB_TOOLSETS 环境变量,例如写成 repos,issues,pull_requests,actions,code_security。先从默认工具集起步,等 Agent 明确需要某个能力时再加。
适合谁用?
- 每天泡在 GitHub 上的开发者:不用离开 Agent 对话就能整理 Issue、审 PR、查 CI。
- 技术负责人:问一句就能拿到待办清单汇总、最久没审的 PR、这周失败的工作流。
- 开源维护者:让 Agent 起草 Issue 回复、给新报告打标签、根据已合并的 PR 写发布说明。
- GitHub 企业云团队:远程服务器与 OAuth 流程都支持企业云账号。
价格
GitHub MCP 服务器免费开源,采用 MIT 许可证。远程服务器随你的 GitHub 账号提供,本地服务器是免费的 Docker 镜像。服务器本身没有付费档;你账号的 GitHub Copilot 或 API 限额仍然适用。
优点与缺点
优点
- GitHub 官方项目,更新快,有正式的安全处理流程。
- 远程服务器支持一键 OAuth 连接,无需本地配置。
- 覆盖完整工作流:仓库、Issue、PR、Actions、代码安全与搜索。
- 工具集与只读模式让你掌控 Agent 的权限边界。
- 免费开源,MIT 许可证。
缺点
- 需要 GitHub 令牌或 OAuth 登录,匿名访问不了私有仓库。
- 本地服务器需要 Docker,部分机器上要额外安装。
- 一次启用全部工具集会让 Agent 的工具列表臃肿,浪费上下文。
- GitHub 企业版服务器不能用托管的远程服务器。
最终评价
如果你的代码在 GitHub 上,这是第一个该装的 MCP 服务器。它是官方出品,维护活跃,免费,而且覆盖的是整个开发工作流,不只是一个角落。先接远程服务器与默认工具集,写操作保持只读,等你信任 Agent 的判断后再放开,按需扩展工具集。很少有 MCP 服务器能这么快证明自己的价值。
