GitHub MCP Server Plus

产品定位

GitHub MCP Server Plus 是一个针对GitHub API的MCP服务器，旨在提供更高级的GitHub操作自动化能力。

核心功能

• 自动分支创建：在创建/更新文件或推送更改时，如果分支不存在会自动创建
• 全面的错误处理：为常见问题提供清晰的错误信息
• Git历史保留：操作会保留正确的Git历史，无需强制推送
• 批量操作：支持单文件和多文件操作，可基于内容或文件路径
• 高级搜索：支持代码、问题/PR和用户的搜索

适用场景

• 自动化GitHub仓库管理
• 批量文件操作
• 代码搜索和分析
• 问题和PR管理
• 持续集成/持续部署(CI/CD)流程

工具列表

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

常见问题解答

1. 如何获取GitHub个人访问令牌？
2. 前往GitHub设置 > 开发者设置 > 个人访问令牌
3. 选择适当的仓库访问权限

4. 创建具有repo范围的令牌

5. 如何与Claude Desktop一起使用？

6. 在claude_desktop_config.json中添加相应的配置
7. 支持Docker和NPX两种运行方式

使用教程

使用依赖

1. 需要安装Node.js和npm
2. 或安装Docker

安装教程

Docker方式

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

NPX方式

npx -y @modelcontextprotocol/server-github

调试方式

1. 确保环境变量GITHUB_PERSONAL_ACCESS_TOKEN已正确设置
2. 使用提供的工具API进行测试
3. 检查错误信息以排查问题

许可证

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