cqbase.net · 中英双语

CQBase 上下文库

Context & Query Base

MCP

GitHub 官方 MCP 服务器

用 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 和 Cursor 指南。远程地址是 https://api.githubcopilot.com/mcp/。请先在 GitHub 设置 创建 PAT,不要把令牌写入仓库。

在 Claude Code 2.1.1 或更新版本,于终端(不要在会话里)添加远程服务器:

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 换成你的令牌并重启:

{
  "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 报告过部分用户在远程 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 使用 MIT 许可。本文依据 2026-11-15 查阅的 README、Claude 与 Cursor 安装指南,用自己的话写成,供 CQBase 上下文库使用。若远程地址、认证方式或 npm 弃用说明有变,以仓库为准。

订阅 CQBase 周刊

每周一封,介绍本周新收录的公开 AI 技能、提示词、MCP 和用法。可随时退订。我们不会把邮箱交给第三方作其营销之用。