
GitHub MCP Server

2025.04.04
0
TypeScriptGitHub API代码管理协作工具开发效率
GitHub MCP Server 是一个用于GitHub API的中间件服务,提供文件操作、仓库管理、搜索功能等核心能力。它支持自动分支创建、批量操作、高级搜索等功能,适用于开发团队进行代码管理和协作。
View on GitHub
Overview
基本能力
产品定位
GitHub MCP Server 是一个中间件服务,旨在简化与GitHub API的交互,提供更高效的文件操作、仓库管理和搜索功能。
核心功能
- 自动分支创建:在创建/更新文件或推送更改时自动创建分支
- 全面的错误处理:提供清晰的错误信息
- Git历史保留:操作保持Git历史记录而不强制推送
- 批量操作:支持单文件和批量文件操作
- 高级搜索:支持代码、问题/PR和用户搜索
适用场景
- 开发团队进行代码管理和协作
- 自动化GitHub仓库操作
- 批量处理GitHub文件
- 高级代码和问题搜索
工具列表
create_or_update_file
:创建或更新单个文件push_files
:推送多个文件search_repositories
:搜索GitHub仓库create_repository
:创建新仓库get_file_contents
:获取文件/目录内容create_issue
:创建新问题create_pull_request
:创建拉取请求fork_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个人访问令牌才能使用
- 支持Docker和NPX两种安装方式
- 提供详细的搜索语法指南
使用教程
使用依赖
- 创建GitHub个人访问令牌:
- 访问Personal access tokens
- 选择适当的仓库访问权限
- 创建具有
repo
或public_repo
范围的令牌
安装教程
Docker方式
{
"mcpServers": {
"github": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GITHUB_PERSONAL_ACCESS_TOKEN",
"mcp/github"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
}
}
}
}
NPX方式
{
"mcpServers": {
"github": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-github"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
}
}
}
}
调试方式
- 构建Docker镜像:
docker build -t mcp/github -f src/github/Dockerfile .
- 运行服务并检查日志输出
- 使用提供的工具进行功能测试