GitHub MCP Server

官方

GitHub 官方 MCP Server，用自然语言管理仓库、Issue、PR 与工作流

分类: 开发工具第 4 / 438
Stars: ★ 33.7k 非常热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Docker · Go · 远程托管（无需本地环境）
凭据: 可选 API Key
许可证: MIT
最近提交: 6 天前
工具数: 15

76FMRS · B

官方 GitHub 团队维护，工具集覆盖仓库全生命周期操作；本地 Docker 和远程 HTTP 两种接入方式文档清晰。核验基于 README 与 server.json，未实际完成握手测试，建议先用只读 toolset 验证再开启写权限。

最强项 · 维护活跃度 18/20 最弱项 · 可靠性 13/20

可靠性

13/20

安全与权限

14/20

维护活跃度

18/20

文档质量

17/20

安装易用性

14/20

实测已过期收录于 2026-07-24

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

需要让 AI 助手直接操作 GitHub 仓库和协作流程的团队
已经在使用 GitHub Copilot 生态、想要远程零部署方案的用户

不适合谁

不希望 AI 助手拥有仓库写权限的场景（应仅启用只读 toolset）
对私有仓库有严格网络隔离要求、不能使用官方远程端点的环境

所需权限

个人访问令牌（PAT）或 OAuth App Token，权限范围取决于令牌本身的 scope
启用 actions/issues/pull_requests 等 toolset 后可对仓库进行写操作，需按最小权限原则申请令牌

风险与副作用

写权限 toolset（如创建/合并 PR、触发 workflow）如果令牌权限过大，可能造成误操作；建议先用只读 toolset 试运行
远程托管模式下凭据通过 Authorization 头传输，需确保客户端到 api.githubcopilot.com 的连接受信任

安装接入

准备工作

运行环境：Docker · Go · 远程托管（无需本地环境）

GITHUB_PERSONAL_ACCESS_TOKEN 可选密钥 GitHub 个人访问令牌，在 github.com/settings/personal-access-tokens 创建；设置后优先于 OAuth 登录。

其他可选配置项（5 个）

GITHUB_OAUTH_CALLBACK_PORT 可选 OAuth 登录回调固定端口（默认 8085），Docker 运行时需与 -p 发布的端口一致。

GITHUB_TOOLSETS 可选逗号分隔的工具集白名单，如 repos,issues；设为 all 启用全部。

GITHUB_TOOLS 可选逗号分隔的具体工具名称白名单，可与工具集叠加使用。

GITHUB_HOST 可选 GitHub Enterprise Server 或 ghe.com 的主机名，需带 https:// 前缀。

GITHUB_INSIDERS 可选设为 true 启用 insiders 版本，提前体验实验性工具。

1）本地运行：docker pull ghcr.io/github/github-mcp-server 后按上方配置启动，首次使用会走 OAuth 登录，也可以用环境变量 GITHUB_PERSONAL_ACCESS_TOKEN 提供个人访问令牌跳过登录。
2）远程连接：直接在客户端配置中把 URL 指向 https://api.githubcopilot.com/mcp/，用 Authorization 头传入 PAT 或 App Token，无需本地安装。
3）按需通过 --toolsets 参数限制启用的工具集，默认只启用 context 上下文工具集。

claude_desktop_config.json

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-p", "127.0.0.1:8085:8085", "-e", "GITHUB_OAUTH_CALLBACK_PORT=8085", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_GITHUB_TOKEN>"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-p",
        "127.0.0.1:8085:8085",
        "-e",
        "GITHUB_OAUTH_CALLBACK_PORT=8085",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_GITHUB_TOKEN>"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add github -e 'GITHUB_PERSONAL_ACCESS_TOKEN=<YOUR_GITHUB_TOKEN>' -- docker run -i --rm -p 127.0.0.1:8085:8085 -e GITHUB_OAUTH_CALLBACK_PORT=8085 -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端连接后调用 get_me（context 工具集），如果返回当前 GitHub 用户信息，说明服务器已正常连接并完成认证。

常见排障

OAuth 回调失败：检查本地端口 8085 是否被占用或被防火墙拦截
工具集未生效：确认 `--toolsets` 参数或对应环境变量拼写正确
远程端点 401：检查 Authorization 头里的 PAT/App Token 是否有效且未过期

试试这样问

连接成功后，可以直接对 AI 助手这样说：

帮我列出 octocorp/api 仓库里所有打开的 issue 并按标签分组总结。
查看主分支最近一次 GitHub Actions 工作流运行失败的原因，并给出失败任务的日志要点。
为仓库 my-app 创建一个名为 bug 的红色标签，然后给 issue #42 加上这个标签。
列出 Dependabot 在 web 仓库报告的高危告警，并说明每个告警影响的依赖。

工具能力 15

context 只读

获取当前用户与所在 GitHub 上下文的信息（强烈建议启用）

actions 写入

GitHub Actions 工作流与 CI/CD 相关操作

code_quality 只读

GitHub Code Quality 相关工具

code_security 只读

代码安全相关工具，例如 Code Scanning

discussions 写入

GitHub Discussions 相关工具

gists 写入

GitHub Gist 相关工具

git 只读

底层 Git 操作相关的 Git API 工具

issues 写入

GitHub Issues 相关工具

展开其余 7 个工具

labels 写入

GitHub Labels 相关工具

notifications 写入

GitHub 通知相关工具

orgs 只读

GitHub 组织相关工具

projects 写入

GitHub Projects 相关工具

pull_requests 写入

Pull Request 的创建、审查与管理

repos 只读

仓库管理相关工具

users 只读

用户信息查询工具

使用场景

用自然语言创建、评论和合并 Pull Request

让 AI 助手排查 GitHub Actions CI 失败原因

批量管理 Issue 标签与通知

在 IDE 里直接查询代码安全扫描结果

支持客户端

Claude Desktop

Claude Code

VS Code

Cursor

Windsurf

JetBrains IDEs

Zed

Amp

依据项目文档列出，未经本站实测。

详细介绍

GitHub 官方维护的 MCP Server，把 GitHub 的核心能力（仓库、Issue、Pull Request、Actions、代码安全扫描、Discussions、组织与项目管理等）通过分组的工具集（toolset）暴露给 AI 助手。既可以在本地通过 Docker 运行，也可以直接连接 GitHub 官方托管的远程 Streamable HTTP 端点（api.githubcopilot.com/mcp/），无需本地部署。