GitHub MCP 服务器

GitHub 官方 MCP 服务器:让 AI Agent 读写仓库、管理 Issue 与 PR、操作 Actions。

MCP 服务器
MCPGitHubDeveloper ToolsAI Agent
已验证

安装

传输方式: 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

质量与安全评分

开源协议100
维护状态95
安全性85
文档质量95
开源协议: MIT
版本: 2.1.0
最近更新: 2026-11-06
GitHub MCP 服务器

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 服务器能这么快证明自己的价值。

在 GitHub 上试用 GitHub MCP 服务器

相似产品