# GitHub 官方 MCP 服务器

Canonical: https://cqbase.net/zh/entry/github-mcp-server
Chinese: https://cqbase.net/zh/entry/github-mcp-server
English: https://cqbase.net/en/entry/github-mcp-server

> 用 MCP 让代理读仓库、议题和拉取请求，而不是把令牌贴进对话。

github/github-mcp-server 是 GitHub 官方的 MCP 服务器，MIT 许可，用 Go 实现。它把仓库、议题、拉取请求这类操作暴露成工具，代理通过协议调用，而不是你在聊天里粘贴一个个人访问令牌。

安装后只授予完成任务需要的权限。让代理总结一个议题，和让它合并拉取请求，不是同一档权限。

## 解决什么问题

GitHub 官方 MCP Server 让编码代理直接调用 GitHub 能力：读仓库和文件、查看或处理 issue 与拉取请求、了解 Actions 等，而不要把个人访问令牌（PAT）贴进对话。它有两种用法：连 GitHub 托管的远程服务器，或在本机用官方 Docker 镜像运行。

默认工具集包括 `context`、`repos`、`issues`、`pull_requests` 和 `users`。常用工具例如 `get_file_contents`、`list_issues`、`list_pull_requests`。需要 Actions、安全扫描等能力时，再按官方说明增加 toolset，不必一开始打开全部。

## 适合谁

适合已经在用 VS Code、Cursor、Claude Code 等 MCP 客户端，并且需要代理在 GitHub 上读仓库或处理 issue / PR 的人。仓库使用 MIT 许可。远程服务器由 GitHub 托管；官方安装指南没有另列一项 MCP 使用费，但 GitHub API 本身仍有速率限制，组织也可能用政策关闭 MCP。本文未查到单独的按次标价，不编造费用。

认证方式因客户端而异。VS Code 等 Copilot 主机可以对远程服务器做 OAuth。官方 Cursor 指南写明：尽管 Cursor 能为部分 MCP 做 OAuth，**当前连接 GitHub 远程服务器仍需 PAT**。Claude Code 的官方指南同样用带 PAT 的远程配置；本机 Docker 则可以走 OAuth（镜像已包含应用凭据，首次会打开浏览器，令牌只留在内存），PAT 若存在会优先于 OAuth。

## 怎么装

核验日期为 2026-11-15（Asia/Shanghai），命令来自仓库 README 以及官方的 [Claude](https://github.com/github/github-mcp-server/blob/main/docs/installation-guides/install-claude.md) 和 [Cursor](https://github.com/github/github-mcp-server/blob/main/docs/installation-guides/install-cursor.md) 指南。远程地址是 `https://api.githubcopilot.com/mcp/`。请先在 [GitHub 设置](https://github.com/settings/personal-access-tokens/new) 创建 PAT，不要把令牌写入仓库。

在 Claude Code 2.1.1 或更新版本，于终端（不要在会话里）添加远程服务器：

```bash
claude mcp add-json github '{"type":"http","url":"https://api.githubcopilot.com/mcp","headers":{"Authorization":"Bearer YOUR_GITHUB_PAT"}}'
```

若这条命令提示 `Invalid input`（官方提到 Windows 上可能出现），改用：`claude mcp add --transport http ...`。加 `--scope user` 可在所有项目中使用。添加后重启 Claude Code，并用 `claude mcp list` 检查。

在 Cursor 中，需 v0.48.0 或更新版本以支持 Streamable HTTP。把下面的配置写入 `~/.cursor/mcp.json`，或项目里的 `.cursor/mcp.json`，再把 `YOUR_GITHUB_PAT` 换成你的令牌并重启：

```json
{
  "mcpServers": {
    "github": {
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_GITHUB_PAT"
      }
    }
  }
}
```

若要在本机运行，官方镜像是 `ghcr.io/github/github-mcp-server`，需要 Docker。**不要再安装** `@modelcontextprotocol/server-github`：官方写明该 npm 包自 2025 年 4 月起不再支持，并且已经不能使用。

## 一个实际例子

Cursor 官方指南用来验证安装的提示词是：`List my GitHub repositories`。本次没有用真实账号实跑，因此不编造仓库列表。

1. 按上一节完成远程或本地配置，确认客户端能看到 GitHub 工具。Cursor 里可看 MCP 是否为绿色标记。
2. 发送：`List my GitHub repositories`。
3. 按默认工具集，代理应通过 GitHub MCP 列出你的令牌有权看到的仓库，而不是让你把令牌贴进聊天。
4. 请自己核对列表是否完整、是否只包含你期望的可见性。若结果为空或报 403，先检查 PAT 权限和组织政策，而不是反复把令牌发给模型。

## 常见坑

- 仍在使用旧的 npm 包。官方安装指南反复强调：`@modelcontextprotocol/server-github` 从 2025 年 4 月起不再支持。请改用远程 URL 或 `ghcr.io/github/github-mcp-server`。
- 远程请求返回 403。[issue #672](https://github.com/github/github-mcp-server/issues/672) 报告过部分用户在远程 MCP 上遇到 403。先确认 PAT 范围、账号是否被组织政策限制，以及「MCP servers in Copilot」一类开关是否打开（若你在 Copilot 环境中使用）。
- Cursor 连不上远程服务器。官方排障要求 Cursor v0.48.0 或更新版本，并检查 JSON 是否有效、改完后是否完全重启。
- 本地 Docker 拉镜像或启动失败。请确认 Docker 正在运行；官方建议必要时先执行 `docker logout ghcr.io` 再重试。
- 把令牌写进聊天或提交到 Git。官方指南明确说不要把 PAT 硬编码进仓库。令牌应放在本地配置或环境变量中，并限制到所需权限。

## FAQ

### 远程模式一定要 PAT 吗？

取决于客户端。VS Code 等主机可以为远程服务器使用 OAuth。官方 Cursor 指南写明，连接 GitHub 远程服务器目前仍需 PAT。Claude Code 的官方远程示例也使用 PAT。本机 Docker 可以走 OAuth，详见官方 OAuth 说明。

### 需要付费的 Copilot 才能用吗？

在部分 Copilot 主机里，管理员政策可能控制 MCP。Claude Code 或 Cursor 按官方指南用 PAT 连接时，文档要求的是兼容的 MCP 客户端和 GitHub 令牌，而不是把 Copilot 订阅写成硬性前提。组织政策仍可能阻止访问。官方没有在这些指南里写出单独的 MCP 标价。

### 默认能做什么？

未指定 toolset 时，默认是 `context`、`repos`、`issues`、`pull_requests` 和 `users`。例如读文件用 `get_file_contents`，列 issue 用 `list_issues`。其他 toolset 要额外打开。

### 令牌能写进对话里让代理保存吗？

不要这样做。官方安装说明就是为了避免把令牌贴进聊天。应写在客户端配置或环境变量里，并加入 `.gitignore`。

### 旧的 npm 包还能用吗？

官方写明，自 2025 年 4 月起不再支持，并且已经不能使用。请改用远程服务器或官方 Docker 镜像。

## 来源与许可

仓库 [github/github-mcp-server](https://github.com/github/github-mcp-server) 使用 MIT 许可。本文依据 2026-11-15 查阅的 README、Claude 与 Cursor 安装指南，用自己的话写成，供 CQBase 上下文库使用。若远程地址、认证方式或 npm 弃用说明有变，以仓库为准。

## 收录信息

- 作者: github
- 许可证: MIT
- 来源: https://github.com/github/github-mcp-server
- 收录: 2026-11-15
- GitHub 星标: 34475（采集 2026-11-15）

