GitHub MCP Server
2025.04.03
1
TypeScript版本控制项目管理团队协作API集成开发效率交流协作
GitHub MCP Server 是一个专为GitHub API设计的中间件服务，提供文件操作、仓库管理、搜索功能和项目管理等核心能力。该服务通过自动化分支创建、批量操作和高级搜索等功能，显著提升GitHub仓库的管理效率。
View on GitHub
Overview
基本能力
产品定位
GitHub API的中间件服务，简化复杂操作并增强GitHub原生功能
核心功能
- 仓库管理：创建/更新文件、批量推送、分支管理、仓库创建/分叉
- 问题追踪：全生命周期管理（创建/查询/更新/删除问题）、评论功能
- PR管理：创建/查询/合并PR、审查管理、分支状态检查
- 高级搜索：代码/问题/用户的多维度搜索（支持复杂语法）
- 项目管理：经典版/新版Projects的完整操作链（含看板/列/卡片管理）
适用场景
- 自动化CI/CD流程中的GitHub操作
- 批量迁移或同步仓库内容
- 构建自定义的GitHub管理仪表盘
- 开发团队协作工具集成
- 开源项目维护自动化
工具列表
| 工具名称 | 能力描述 |
|---|---|
create_or_update_file |
单文件创建/更新（自动处理分支） |
push_files |
多文件原子提交（单commit批量操作） |
search_repositories |
多条件仓库搜索（支持分页） |
create_issue |
带标签/分配的问题创建 |
create_pull_request |
可配置的PR创建（含草稿模式） |
get_pull_request_files |
获取PR变更文件详情（含diff） |
add_card_to_column |
在看板列中添加问题/PR/笔记卡片 |
search_code |
语法感知的代码搜索（支持语言/路径过滤） |
update_project_v2 |
新版Projects的元数据更新 |
常见问题
- 权限问题：需配置
repo+project范围的PAT - 项目兼容性：经典版Projects将被逐步淘汰
- 批量限制：搜索类操作单次最多返回100条结果
使用教程
使用依赖
- 创建GitHub Personal Access Token：
bash # 访问 https://github.com/settings/tokens # 勾选 repo 和 project 权限范围
安装教程
Docker方式：
docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN=<YOUR_TOKEN> ghcr.io/tuanle96/mcp-github
NPX方式：
npx -y @earnbasejs/mcp-github
调试方式
- 验证基础功能：
bash # 测试仓库搜索 curl -X POST http://localhost:3000 -d '{"tool":"search_repositories","query":"mcp"}' - 检查项目权限：
bash # 测试项目创建 curl -X POST http://localhost:3000 -d '{"tool":"create_project","owner":"your_org","repo":"test","name":"Debug Project"}'