GitHub MCP Server(官方MCP)

作者 设施特

让 AI 改代码,它却看不见你的仓库、Issue 和 CI 结果,只能靠你复制粘贴。这是 GitHub 官方的 MCP Server,把仓库读写、Issue/PR 管理、Actions 排障、代码安全告警一次接给 Agent,托管版免部署,本地版一条 docker run。

Github
Skill 编程开发 v1.0.0 热度 460

将提示词发送给你的 AI 安装该 Skill

复制下方提示词,粘贴到 Cursor / Claude Code / WorkBuddy 等本地 Agent,按说明安装。

请根据 https://www.cweto.cn/?ai_hub=skill_install ,安装本站 Skill @ai_hub/work-58(GitHub MCP Server(官方MCP))。
详情页:https://www.cweto.cn/work-58.html
GitHub:https://github.com/github/github-mcp-server
请装到当前 Agent 的 skills 目录(见安装说明中的路径表),完成后重启或刷新 Agent。
安装说明 GitHub
支持的本地 Agent 目录
  • Claude Code → ~/.claude/skills/
  • Cursor → ~/.cursor/skills/
  • Windsurf → ~/.codeium/windsurf/skills/
  • Codex → ~/.codex/skills/
  • Gemini CLI → ~/.gemini/skills/
  • WorkBuddy → ~/.workbuddy/skills/
  • OpenClaw 变体 → 各自 skills 目录

Skill 说明

GitHub MCP Server 是什么

GitHub MCP Server 是 GitHub 官方的 MCP 服务端,作用是把 AI 工具直接连到 GitHub 平台上。接上之后,AI Agent、助手和聊天机器人可以用自然语言读仓库和代码文件、管理 Issue 和 PR、分析代码、自动化工作流。

官方列出的使用场景是这几类:仓库管理(浏览查询代码、搜索文件、分析提交、理解项目结构)、Issue 与 PR 自动化(创建更新管理、辅助 triage、评审代码改动)、CI/CD 与工作流洞察(监控 Actions 运行、分析构建失败、管理发布)、代码分析(看安全发现、看 Dependabot 告警、理解代码模式)、团队协作(访问讨论、管理通知、分析团队活动)。

部署形态说明
远程托管https://api.githubcopilot.com/mcp/,GitHub 托管,免自己部署
本地 Dockerghcr.io/github/github-mcp-server,OAuth 回调固定 127.0.0.1:8085
认证方式OAuth(token 只存内存)或 GITHUB_PERSONAL_ACCESS_TOKEN(优先级更高)
兼容宿主VS Code 1.101+、Claude Desktop、Cursor、Windsurf 等支持 MCP 的客户端

远程版不需要你事先准备什么——一键安装按钮会在首次使用时走 OAuth 浏览器登录。本地版更适合企业内网或需要自己控制凭据的场景,GitHub Enterprise Server 和企业托管版需要自带 OAuth 或 GitHub App。

GitHub MCP Server 怎么安装

远程版最省事。VS Code 1.101 及以上,在配置里加一段即可,走 OAuth:

{
  "servers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    }
  }
}

改用 PAT 的话,加 headers 和 inputs:

{
  "servers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": { "Authorization": "Bearer ${input:github_mcp_pat}" }
    }
  },
  "inputs": [
    { "type": "promptString", "id": "github_mcp_pat", "description": "GitHub Personal Access Token", "password": true }
  ]
}

本地版需要先装 Docker 并确保在运行,然后:

docker run -i --rm -p 127.0.0.1:8085:8085 
  -e GITHUB_OAUTH_CALLBACK_PORT=8085 
  ghcr.io/github/github-mcp-server

想用 PAT 而不是 OAuth,把 GITHUB_PERSONAL_ACCESS_TOKEN 传进去。镜像公开,如果拉取报错,可能是 ghcr.io 的 token 过期,执行 docker logout ghcr.io 再试。

GitHub MCP Server 怎么使用

  1. 装好之后在宿主里启用 Agent 模式(比如 VS Code 里 Copilot Chat 输入框的位置),服务会自动启动。
  2. 直接用自然语言提要求:这个 PR 改了什么、为什么 CI 挂了、把这条 issue 标成分类、这段代码有安全问题吗。
  3. PAT 按最小权限给:repo 做仓库操作、read:packages 拉镜像、read:org 读组织团队。别一把全给。
  4. 不同环境用不同 token,避免一个 token 通吃所有仓库。
  5. 走 CLI 接入的话,可以把它写进命令行工具的 MCP 配置,例如 claude mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN=$GITHUB_PAT -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server。

把 PAT 放在环境变量或 .env 里,记得把 .env 加进 .gitignore。部分宿主(如 Windsurf)不支持环境变量展开,只能把 token 写进配置文件,这种场景要格外注意文件权限。

GitHub MCP Server 适合谁用

  • 用 Claude、Cursor、VS Code 写代码,想让 AI 直接读仓库和 Issue 而不用复制粘贴的开发者。
  • 要让 AI 参与 issue 分类、代码评审、发布管理的团队。
  • 排 CI 失败、查 Actions 日志这类需要跨仓库上下文的工作。
  • 企业环境需要自己控凭据、走内网、接 GitHub Enterprise Server 的场景。
  • 不用任何 MCP 宿主的纯命令行工作流,直接装 gh 或调 API 更直接。

GitHub MCP Server 项目地址

  • GitHub 仓库:https://github.com/github/github-mcp-server
  • 本地 OAuth 登录说明:https://github.com/github/github-mcp-server/blob/main/docs/oauth-login.md
  • 策略与治理:https://github.com/github/github-mcp-server/blob/main/docs/policies-and-governance.md
  • Docker 镜像:https://github.com/github/github-mcp-server/pkgs/container/github-mcp-server
  • 远程服务地址:https://api.githubcopilot.com/mcp/
  • 创建 PAT:https://github.com/settings/personal-access-tokens/new