对比决策指南
GitHub CLI 与 GitHub MCP 对比
本地 Git 和 shell 上下文重要时用 gh；需要受中介的 GitHub 操作目录时用 GitHub MCP。
接口决策只读GitHub CLIGitHub MCP
先看决策矩阵
基于官方文档这张表汇总当前注册表和官方来源，不代表两侧已经在同一环境中完成端到端对跑。真正选择前，请用同一个安全样例验证。
| 决策条件 | GitHub CLI | GitHub MCP |
|---|---|---|
| 输出合同 | 结构化格式：json；标志：--json, --jq。 | 由服务端工具 schema 定义输入与输出；具体稳定性取决于所连接的 MCP Server。 |
| 认证与身份 | 需要认证：OAuth, personal access token, GitHub Actions token。使用只读或细粒度 Token，并仅授权任务所需仓库。 | 通常由 MCP Client 或 Server 中介身份与权限；仍需核对实际服务的授权范围。 |
| 可靠性证据 | 证据状态为 verified，文档检查于 2026-07-10；已记录独立测试版本 2.86.0。 | Typed tool 有助于约束参数，但可用性还取决于 Server、会话和实现；本页不是端到端实测。 |
| 更适合 | 使用 GitHub 官方 CLI 审查拉取请求、处理 Issue、检查 Actions 并管理发布。 | 适合需要可发现 GitHub tools、受控 toolset 和集中身份的 Agent。 |
当前建议
本地审查用 gh；集中工具暴露能明显改善治理时选择 MCP。
目标、输入与输出
在 Agent 选择命令前，先明确要交付的结果和证据。
GitHub CLI 与 GitHub MCP 对比：安全执行步骤
每一步都要在已声明的边界内执行，验证输出后再继续。
审批点与回滚
在列出的决策点停下，并让恢复方法始终紧跟操作。
选 CLI、MCP 还是 API？
根据执行位置、身份、输出合同与权限边界选接口。
建议方案
本地审查用 gh；集中工具暴露能明显改善治理时选择 MCP。
官方证据与参考
执行前使用这些官方或上游来源确认当前命令行为。