
GitHub MCP Server

2025.04.03
0
TypeScriptGitHub自动化仓库管理代码搜索CI/CD集成开发效率交流协作
GitHub MCP Server 是一个针对GitHub API的中间件服务,提供文件操作、仓库管理、搜索功能等核心能力。它支持自动分支创建、批量操作、高级搜索等功能,并保持Git历史完整性。适用于需要自动化GitHub操作、批量处理仓库内容或构建GitHub相关工具的场景。
View on GitHub
Overview
基本能力
产品定位
GitHub MCP Server 是一个GitHub API的增强中间件,旨在简化复杂的GitHub操作流程,提供更高效的仓库管理和自动化能力。
核心功能
- 自动分支创建:在文件操作时自动处理分支逻辑
- 批量操作支持:支持单文件和多文件操作
- 高级搜索:代码、Issue/PR、用户的多维度搜索
- Git历史保护:所有操作均保持完整的Git历史记录
- 全面错误处理:清晰的错误提示机制
适用场景
- 自动化GitHub工作流
- 批量处理仓库内容
- 构建GitHub相关工具
- CI/CD流程集成
- 代码搜索和分析
工具列表
create_or_update_file
- 创建/更新单个文件push_files
- 批量推送文件search_repositories
- 仓库搜索create_repository
- 创建新仓库get_file_contents
- 获取文件内容create_issue
- 创建Issuecreate_pull_request
- 创建PRfork_repository
- Fork仓库create_branch
- 创建分支list_issues
- 列出Issueupdate_issue
- 更新Issueadd_issue_comment
- 添加Issue评论search_code
- 代码搜索search_issues
- Issue/PR搜索search_users
- 用户搜索list_commits
- 列出提交get_issue
- 获取Issue详情get_pull_request
- 获取PR详情list_pull_requests
- 列出PRcreate_pull_request_review
- 创建PR评审merge_pull_request
- 合并PRget_pull_request_files
- 获取PR文件变更get_pull_request_status
- 获取PR状态update_pull_request_branch
- 更新PR分支get_pull_request_comments
- 获取PR评论get_pull_request_reviews
- 获取PR评审list_workflow_runs
- 列出工作流运行get_workflow_run
- 获取工作流运行详情list_workflow_runs_by_workflow_id
- 按工作流ID列出运行get_workflow_run_logs
- 获取工作流日志download_and_unzip
- 下载并解压文件
常见问题
- 需要GitHub Personal Access Token才能使用
- 批量操作时注意API速率限制
- 文件操作会自动创建分支
- 搜索功能支持GitHub原生查询语法
使用教程
使用依赖
- 创建GitHub Personal Access Token:
# 访问 https://github.com/settings/tokens
# 选择repo或public_repo权限
安装教程
Docker方式:
docker build -t mcp/github -f src/github/Dockerfile .
NPX方式:
npx -y @modelcontextprotocol/server-github
调试方式
- 设置环境变量:
export GITHUB_PERSONAL_ACCESS_TOKEN="your_token"
- 测试基本功能:
# 测试仓库搜索
curl -X POST http://localhost:3000/search_repositories -d '{"query":"mcp"}'