GitHub MCP Server

它做什么

• 完整仓库操作：get_file_contents、create_or_update_file、push_files、create_branch、create_repository
• Issue + PR 工作流：list / create / update / close issues，list / create / merge pull requests with reviews
• 跨组织代码搜索：search_code / search_issues / search_pull_requests 工具
• GitHub Actions：list workflow runs、get workflow logs、按名字触发 workflow
• GitHub 原生安全：secret scanning、Dependabot alerts、code-scanning alerts 都能通过专门工具读出

什么时候用

最适合涉及真实仓库的 Claude Code 工作流——自动 PR 评审、依赖升级 PR、按 label 分流、从已合并 PR 生成 release notes 草稿。项目在 GitHub 时的默认选择；自托管 Gitea / GitLab 配对应的 MCP server。

如何上手

在 .mcp.json 的 mcpServers.github 下加：

{
  "command": "docker",
  "args": ["run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server"]
}

env 里设 GITHUB_PERSONAL_ACCESS_TOKEN（推荐用 fine-grained token，scope 限制到实际需要的仓库）。

注意事项

默认 token scope 是用户账户下所有仓库——缩到只让 Claude 接触的仓库范围。create_or_update_file、push_files 这类写操作可能覆盖历史；把 token 限制为 read + 定向 write，Claude 开的 PR 合并前人工审一遍。