GitHub MCP 工具集与只读模式
按任务选择工具集、单项工具和排除项，并区分远程请求头与本地参数。
工具集决定 GitHub MCP 暴露哪些能力。只启用当前任务需要的部分，有助于减少工具上下文，并让可用操作更清楚；仍需目标账号具有相应 GitHub 权限。
默认集合与扩展
GitHub Docs 工具集页只列 repos、issues、pull_requests 为默认集合；服务器仓库当前配置指南还列出 context、users。两处列表不同，完整默认范围以实际服务器版本和工具列表为准。
default 可与额外工具集组合，例如 default,stargazers；all 表示启用所有可用工具集。actions、code_security、secret_protection 等按需要选择。部分工具集仅在远程服务提供，Spaces 需要单独启用。
配置入口对照
| 目标 | 远程请求头 | 本地参数 / 环境变量 |
|---|---|---|
| 工具集 | X-MCP-Toolsets | --toolsets / GITHUB_TOOLSETS |
| 单项工具 | X-MCP-Tools | --tools / GITHUB_TOOLS |
| 排除工具 | X-MCP-Exclude-Tools | --exclude-tools / GITHUB_EXCLUDE_TOOLS |
| 只读模式 | X-MCP-Readonly | --read-only / GITHUB_READ_ONLY |
本地环境变量高于命令行参数。排除名单优先于已启用的工具集和单项工具；只读模式会禁用写工具，即使它们被显式请求。
远程 URL 方式
单个工具集可用路径，例如 https://api.githubcopilot.com/mcp/x/issues。追加 /readonly 可只保留读取能力。
/x/{toolset} 只接受一个工具集，不能把逗号列表放入该位置。需要多个集合时使用 X-MCP-Toolsets 请求头，例如 repos,issues。
错误与确认
远程参考说明，未知工具集会被忽略；空工具集列表回到默认集合。单项工具名无效则可能导致启动错误，不能用“服务启动了”判断每个工具集都生效。
保存后重新查看 IDE 的工具列表，核对确实出现预期工具。请求头应放在当前客户端支持的位置，参阅 VS Code或其他 IDE。
Spaces 的完整请求头配置见IDE Spaces。