用途：GitHub MCP Server 为 AI 代理提供通过 Model Context Protocol 访问 GitHub API 的程序化能力。支持两种运行模式。本地模式（基于 Docker）在 GitHub Actions 运行器上以容器运行，使用 GITHUB_PERSONAL_ACCESS_TOKEN 环境变量认证，可通过 GITHUB_TOOLSETS 配置工具集，通过 GITHUB_READ_ONLY 启用只读。远程模式连接托管服务器 https://api.githubcopilot.com/mcp/，使用 HTTP 头中的 Bearer 令牌认证，通过 X-MCP-Readonly 头启用只读，无需 Docker 容器。
主要能力：服务器按工具集组织工具。默认启用 context、repos、issues、pull_requests；其他可用工具集包括 actions、code_security、dependabot、discussions、experiments、gists、labels、notifications、orgs、projects、secret_protection、security_advisories、stargazers、users、search。可用 [default]、[all] 或具体列表选择工具集。配置中支持 read-only 与自定义 github-token。
使用方式：推荐使用 toolsets 而非逐个列出工具名，工具集提供稳定 API，工具名可能随版本变化。迁移步骤包括识别当前工具、映射到工具集、替换配置，然后运行 gh aw mcp inspect <workflow> 验证、gh aw compile 更新锁文件。远程模式认证默认使用 secrets.GH_AW_GITHUB_TOKEN 或 secrets.GITHUB_TOKEN。
限制：get_me 在集成令牌下返回 403，不建议调用，应从 <github-context> 块读取身份。计费与成本数据不通过标准 API 权限提供；跨组织数据需明确授权；组织成员与私有数据需额外 scope；受 API 速率限制。list_code_scanning_alerts 应始终包含 state: open 与 severity: critical,high。文档由工作流自动生成，手动修改可能被覆盖。