GitHub MCP Server - FindMCP.info

Overview

基本能力

产品定位

GitHub MCP Server 是一个用于与 GitHub API 交互的服务，旨在简化 GitHub 仓库管理、文件操作、搜索功能等。

核心功能

自动分支创建：在创建/更新文件或推送更改时，自动创建不存在的分支
全面的错误处理：提供清晰的错误消息
Git 历史保留：操作保持正确的 Git 历史记录，无需强制推送
批量操作：支持单文件和多文件操作
高级搜索：支持搜索代码、问题/PR 和用户

适用场景

自动化 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：搜索问题和 PR
search_users：搜索用户
list_commits：获取提交列表
get_issue：获取问题内容
get_pull_request：获取 PR 详情
list_pull_requests：列出和过滤 PR
create_pull_request_review：创建 PR 审查
merge_pull_request：合并 PR
get_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_sub_issues：列出子问题
reprioritize_sub_issue：重新排序子问题
remove_sub_issue：移除子问题
add_sub_issue：添加子问题
list_labels_for_issue：列出问题标签
add_labels_to_issue：添加标签到问题
set_labels_for_issue：设置问题标签
remove_label_from_issue：移除问题标签
remove_all_labels_from_issue：移除所有问题标签
list_labels_for_repo：列出仓库标签
create_label：创建标签
get_label：获取标签
update_label：更新标签
delete_label：删除标签
list_labels_for_milestone：列出里程碑标签
list_milestones：列出里程碑
create_milestone：创建里程碑
get_milestone：获取里程碑
update_milestone：更新里程碑
delete_milestone：删除里程碑

常见问题解答

需要创建 GitHub 个人访问令牌才能使用该服务
确保令牌具有足够的权限（repo 或 public_repo 范围）
使用 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>"
      }
    }
  }
}

调试方式

确保环境变量 GITHUB_PERSONAL_ACCESS_TOKEN 已正确设置
检查服务是否正常运行
使用工具列表中的功能进行测试，如 search_repositories 或 get_file_contents
查看错误消息以排查问题

构建

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

许可证

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