GitHub MCP Server

基本能力

产品定位

zerops-mcp 是一个基于 GitHub API 的 MCP 服务器，旨在简化 GitHub 仓库的管理和操作，提供丰富的 API 功能。

核心功能

• 自动分支创建：在创建/更新文件或推送更改时，自动创建不存在的分支。
• 全面的错误处理：提供清晰的错误消息。
• Git 历史保留：操作保持 Git 历史，无需强制推送。
• 批量操作：支持单文件和多文件操作。
• 高级搜索：支持代码、问题/PR 和用户的搜索。

适用场景

• 开发团队协作管理 GitHub 仓库。
• 自动化 GitHub 仓库操作（如批量文件更新）。
• 开源项目的管理和维护。

工具列表

1. create_or_update_file：创建或更新单个文件。
2. push_files：推送多个文件。
3. search_repositories：搜索 GitHub 仓库。
4. create_repository：创建新仓库。
5. get_file_contents：获取文件/目录内容。
6. create_issue：创建新问题。
7. create_pull_request：创建新 PR。
8. fork_repository：分叉仓库。
9. create_branch：创建新分支。
10. list_issues：列出和过滤问题。
11. update_issue：更新问题。
12. add_issue_comment：添加问题评论。
13. search_code：搜索代码。
14. search_issues：搜索问题和 PR。
15. search_users：搜索用户。
16. list_commits：获取分支提交。
17. get_issue：获取问题内容。
18. get_pull_request：获取 PR 详情。
19. list_pull_requests：列出和过滤 PR。
20. create_pull_request_review：创建 PR 审查。
21. merge_pull_request：合并 PR。
22. get_pull_request_files：获取 PR 更改文件。
23. get_pull_request_status：获取 PR 状态检查。
24. update_pull_request_branch：更新 PR 分支。
25. get_pull_request_comments：获取 PR 评论。
26. get_pull_request_reviews：获取 PR 审查。

常见问题解答

• 如何获取 GitHub 个人访问令牌？ 创建令牌时选择 repo 或 public_repo 权限。
• 如何与 Claude Desktop 集成？ 在 claude_desktop_config.json 中配置 Docker 或 NPX 命令。

使用教程

使用依赖

• 需要 GitHub 个人访问令牌。

安装教程

Docker

docker build -t mcp/github -f src/github/Dockerfile .

NPX

npx -y @modelcontextprotocol/server-github

调试方式

• 确保环境变量 GITHUB_PERSONAL_ACCESS_TOKEN 已正确设置。
• 检查 Docker 或 NPX 命令是否正确执行。

许可证

该项目遵循 MIT 开源许可条款。