
GitHub MCP Server

2025.03.30
0
TypeScript代码管理开发协作自动化工作流开发效率交流协作
GitHub MCP Server 是一个基于 GitHub API 的 MCP 服务,提供文件操作、仓库管理、搜索功能等。它支持自动分支创建、错误处理、Git 历史保留、批量操作和高级搜索等功能,适用于开发团队协作和代码管理。
View on GitHub
Overview
基本能力
产品定位
GitHub MCP Server 是一个基于 GitHub API 的 MCP 服务,旨在简化 GitHub 仓库的管理和操作,提供高效的开发协作工具。
核心功能
- 自动分支创建:在创建/更新文件或推送更改时自动创建分支
- 全面的错误处理:提供清晰的错误消息
- Git 历史保留:操作保持 Git 历史,无需强制推送
- 批量操作:支持单文件和多文件操作
- 高级搜索:支持代码、问题/PR 和用户搜索
适用场景
- 开发团队协作
- 代码管理
- 自动化工作流
工具列表
create_or_update_file
:创建或更新单个文件push_files
:推送多个文件search_repositories
:搜索 GitHub 仓库create_repository
:创建新仓库get_file_contents
:获取文件/目录内容create_issue
:创建新问题create_pull_request
:创建新 PRfork_repository
:分叉仓库create_branch
:创建新分支list_issues
:列出和过滤问题update_issue
:更新问题add_issue_comment
:添加问题评论search_code
:搜索代码search_issues
:搜索问题和 PRsearch_users
:搜索用户list_commits
:获取分支提交get_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 审查
常见问题解答
- 如何设置个人访问令牌:在 GitHub 设置中创建具有
repo
或public_repo
范围的令牌 - 如何使用 Docker:通过 Docker 运行服务并设置环境变量
- 如何使用 NPX:通过 NPX 直接运行服务
使用教程
使用依赖
- 创建 GitHub 个人访问令牌:
- 访问 Personal access tokens
- 选择适当的仓库访问权限
- 创建具有
repo
或public_repo
范围的令牌
安装教程
Docker 安装
docker build -t mcp/github -f Dockerfile .
NPX 安装
{
"mcpServers": {
"github": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-github"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
}
}
}
}
调试方式
- 确保环境变量
GITHUB_PERSONAL_ACCESS_TOKEN
已正确设置 - 使用
docker run
或npx
命令启动服务 - 检查日志以确认服务正常运行