GitHub MCP Server Plus

Name: GitHub MCP Server Plus
Author: PhialsBasement

本地服务

github.com/PhialsBasement版本控制877 周前更新

代码仓库

关于 GitHub MCP Server Plus

GitHub MCP Server Plus 提供 GitHub API 操作，用于仓库工作、搜索以及管理 Issue 和 Pull Request。它支持批量更新文件，并可按需创建分支，还提供审查和合并 Pull Request 的工具。

主要功能

01创建和更新仓库文件
02在一次提交中推送多个文件
03搜索仓库、代码、Issue 和用户
04管理 Issue 和 Pull Request
05创建分支和派生仓库

适用场景

01提交单个或多个仓库文件
02查找代码和 GitHub 讨论
03审查、更新或合并 Pull Request

MCP 相关

它向 MCP 客户端提供 GitHub API 工具，用于文件操作、仓库管理、搜索以及 Issue 和 Pull Request 工作流。

#github #mcp-server #repository-management

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "github-server-plus": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "build"
      ]
    }
  }
}

启动命令docker run -i --rm build

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

ocibuildstdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

GitHub MCP Server Plus

npm 下载量

GitHub API 的 MCP 服务，支持文件操作、仓库管理、搜索功能等。

功能

自动创建分支：创建或更新文件、推送更改时，如果分支不存在，会自动创建
全面的错误处理：针对常见问题提供清晰的错误消息
保留 Git 历史记录：操作会妥善维护 Git 历史记录，不使用强制推送
批量操作：支持使用内容或文件路径进行单文件和多文件操作
高级搜索：支持搜索代码、问题/PR 和用户

工具

create_or_update_file
- 在仓库中创建或更新单个文件
- 输入：
  - owner (string)：仓库所有者（用户名或组织）
  - repo (string)：仓库名称
  - path (string)：创建或更新文件的路径
  - content (string)：文件内容
  - message (string)：提交消息
  - branch (string)：创建或更新文件所在的分支
  - sha (optional string)：被替换文件的 SHA（用于更新）
- 返回：文件内容和提交详情
push_files_content
- 在单次提交中直接推送多个文件的内容
- 输入：
  - owner (string)：仓库所有者
  - repo (string)：仓库名称
  - branch (string)：推送到的分支
  - files (array)：要推送的文件，每个文件包含 path 和 content
  - message (string)：提交消息
- 返回：更新后的分支引用
push_files_from_path
- 在单次提交中从文件系统路径推送多个文件
- 输入：
  - owner (string)：仓库所有者
  - repo (string)：仓库名称
  - branch (string)：推送到的分支
  - files (array)：要推送的文件，每个文件包含：
    - path (string)：仓库中的目标路径
    - filepath (string)：要读取的源文件系统路径
  - message (string)：提交消息
- 返回：更新后的分支引用
search_repositories
- 搜索 GitHub 仓库
- 输入：
  - query (string)：搜索查询
  - page (optional number)：分页页码
  - perPage (optional number)：每页结果数（最多 100）
- 返回：仓库搜索结果
create_repository
- 创建新的 GitHub 仓库
- 输入：
  - name (string)：仓库名称
  - description (optional string)：仓库描述
  - private (optional boolean)：是否将仓库设为私有
  - autoInit (optional boolean)：使用 README 初始化
- 返回：已创建的仓库详情
get_file_contents
- 获取文件或目录的内容
- 输入：
  - owner (string)：仓库所有者
  - repo (string)：仓库名称
  - path (string)：文件或目录的路径
  - branch (optional string)：获取内容的分支
- 返回：文件或目录内容
create_issue
- 创建新问题
- 输入：
  - owner (string)：仓库所有者
  - repo (string)：仓库名称
  - title (string)：问题标题
  - body (optional string)：问题描述
  - assignees (optional string[])：要指派的用户名
  - labels (optional string[])：要添加的标签
  - milestone (optional number)：里程碑编号
- 返回：已创建的问题详情
create_pull_request
- 创建新的拉取请求
- 输入：
  - owner (string)：仓库所有者
  - repo (string)：仓库名称
  - title (string)：PR 标题
  - body (optional string)：PR 描述
  - head (string)：包含更改的分支
  - base (string)：要合并到的分支
  - draft (optional boolean)：创建为草稿 PR
  - maintainer_can_modify (optional boolean)：允许维护者编辑
- 返回：已创建的拉取请求详情
fork_repository
- 复刻仓库
- 输入：
  - owner (string)：仓库所有者
  - repo (string)：仓库名称
  - organization (optional string)：要复刻到的组织
- 返回：已复刻的仓库详情
create_branch
- 创建新分支
- 输入：
  - owner (string)：仓库所有者
  - repo (string)：仓库名称
  - branch (string)：新分支名称
  - from_branch (optional string)：源分支（默认为仓库默认分支）
- 返回：已创建的分支引用
list_issues
- 列出并筛选仓库议题
- 输入：
  - owner (string)：仓库所有者
  - repo (string)：仓库名称
  - state (optional string)：按状态筛选（'open'、'closed'、'all'）
  - labels (optional string[])：按标签筛选
  - sort (optional string)：按（'created'、'updated'、'comments'）排序
  - direction (optional string)：排序方向（'asc'、'desc'）
  - since (optional string)：按日期筛选（ISO 8601 时间戳）
  - page (optional number)：页码
  - per_page (optional number)：每页结果数
- 返回：议题详情数组
update_issue
- 更新现有议题
- 输入：
  - owner (string)：仓库所有者
  - repo (string)：仓库名称
  - issue_number (number)：要更新的议题编号
  - title (optional string)：新标题
  - body (optional string)：新描述
  - state (optional string)：新状态（'open' 或 'closed'）
  - labels (optional string[])：新标签
  - assignees (optional string[])：新的受指派人
  - milestone (optional number)：新里程碑编号
- 返回：已更新的议题详情
add_issue_comment
- 为议题添加评论
- 输入：
  - owner (string)：仓库所有者
  - repo (string)：仓库名称
  - issue_number (number)：要评论的议题编号
  - body (string)：评论内容
- 返回：已创建的评论详情
search_code
- 在 GitHub 仓库中搜索代码
- 输入：
  - q (string)：使用 GitHub 代码搜索语法的搜索查询
  - sort (optional string)：排序字段（仅支持 'indexed'）
  - order (optional string)：排序顺序（'asc' 或 'desc'）
  - per_page (optional number)：每页结果数（最多 100）
  - page (optional number)：页码
- 返回：包含仓库上下文的代码搜索结果
search_issues
- 搜索议题和拉取请求
- 输入：
  - q (string)：使用 GitHub 议题搜索语法的搜索查询
  - sort (optional string)：排序字段（comments、reactions、created 等）
  - order (optional string)：排序顺序（'asc' 或 'desc'）
  - per_page (optional number)：每页结果数（最多 100）
  - page (optional number)：页码
- 返回：议题和拉取请求搜索结果
search_users
- 搜索 GitHub 用户
- 输入：
  - q (string)：使用 GitHub 用户搜索语法的搜索查询
  - sort (optional string)：排序字段（followers、repositories、joined）
  - order (optional string)：排序顺序（'asc' 或 'desc'）
  - per_page (optional number)：每页结果数（最多 100）
  - page (optional number)：页码
- 返回：用户搜索结果
list_commits
- 获取仓库中某个分支的提交记录
- 输入：
  - owner（string）：仓库所有者
  - repo（string）：仓库名称
  - page（可选 string）：页码
  - per_page（可选 string）：每页记录数
  - sha（可选 string）：分支名称
- 返回：提交记录列表
get_issue
- 获取仓库中某个议题的内容
- 输入：
  - owner（string）：仓库所有者
  - repo（string）：仓库名称
  - issue_number（number）：要获取的议题编号
- 返回：GitHub Issue 对象及详细信息
get_pull_request
- 获取特定拉取请求的详细信息
- 输入：
  - owner（string）：仓库所有者
  - repo（string）：仓库名称
  - pull_number（number）：拉取请求编号
- 返回：拉取请求详细信息，包括差异和审查状态
list_pull_requests
- 列出并筛选仓库的拉取请求
- 输入：
  - owner（string）：仓库所有者
  - repo（string）：仓库名称
  - state（可选 string）：按状态筛选（'open'、'closed'、'all'）
  - head（可选 string）：按头部分支的用户/组织和分支筛选
  - base（可选 string）：按基础分支筛选
  - sort（可选 string）：按（'created'、'updated'、'popularity'、'long-running'）排序
  - direction（可选 string）：排序方向（'asc'、'desc'）
  - per_page（可选 number）：每页结果数（最多 100）
  - page（可选 number）：页码
- 返回：拉取请求详细信息数组
create_pull_request_review
- 对拉取请求进行审查
- 输入：
  - owner（string）：仓库所有者
  - repo（string）：仓库名称
  - pull_number（number）：拉取请求编号
  - body（string）：审查评论文本
  - event（string）：审查操作（'APPROVE'、'REQUEST_CHANGES'、'COMMENT'）
  - commit_id（可选 string）：要审查的提交 SHA
  - comments（可选 array）：针对特定行的评论，每条包含：
    - path（string）：文件路径
    - position（number）：差异中的行位置
    - body（string）：评论文本
- 返回：已创建的审查详细信息
merge_pull_request
- 合并拉取请求
- 输入：
  - owner（string）：仓库所有者
  - repo（string）：仓库名称
  - pull_number（number）：拉取请求编号
  - commit_title（可选 string）：合并提交的标题
  - commit_message（可选 string）：合并提交的补充说明
  - merge_method（可选 string）：合并方式（'merge'、'squash'、'rebase'）
- 返回：合并结果详细信息
get_pull_request_files
- 获取拉取请求中已更改文件的列表
- 输入：
  - owner（string）：仓库所有者
  - repo（string）：仓库名称
  - pull_number（number）：拉取请求编号
- 返回：已更改文件数组，包含补丁和状态详细信息
get_pull_request_status
- 获取拉取请求所有状态检查的汇总状态
- 输入：
  - owner（string）：仓库所有者
  - repo（string）：仓库名称
  - pull_number（number）：拉取请求编号
- 返回：状态检查汇总结果和各项检查的详细信息
update_pull_request_branch
- 使用基础分支中的最新更改更新拉取请求分支
- 输入：
  - owner（string）：仓库所有者
  - repo（string）：仓库名称
  - pull_number（number）：拉取请求编号
  - expected_head_sha（可选 string）：拉取请求 HEAD 引用的预期 SHA
- 返回：分支更新成功时的消息
get_pull_request_comments
- 获取拉取请求上的审查评论
- 输入：
  - owner（string）：仓库所有者
  - repo（string）：仓库名称
  - pull_number（number）：拉取请求编号
- 返回：拉取请求审查评论数组
get_pull_request_reviews
- 获取拉取请求上的审查
- 输入：
  - owner（string）：仓库所有者
  - repo（string）：仓库名称
  - pull_number（number）：拉取请求编号
- 返回：拉取请求审查数组

搜索查询语法

代码搜索

language:javascript：按编程语言搜索
repo:owner/name：在指定仓库中搜索
path:app/src：在指定路径中搜索
extension:js：按文件扩展名搜索
示例：q: "import express" language:typescript path:src/

问题搜索

is:issue 或 is:pr：按类型筛选
is:open 或 is:closed：按状态筛选
label:bug：按标签搜索
author:username：按作者搜索
示例：q: "memory leak" is:issue is:open label:bug

用户搜索

type:user 或 type:org：按账户类型筛选
followers:>1000：按关注者数量筛选
location:London：按所在地搜索
示例：q: "fullstack developer" location:London followers:>100

如需详细了解搜索语法，请参阅 GitHub 的搜索文档。

设置

个人访问令牌

创建具有适当权限的 GitHub 个人访问令牌：

前往 Personal access tokens（位于 GitHub Settings > Developer settings）
选择此令牌可以访问哪些仓库（Public、All 或 Select）
创建具有 repo 作用域（“对私有仓库的完全控制”）的令牌
- 或者，如果仅使用公共仓库，请只选择 public_repo 作用域
复制生成的令牌

在 Claude Desktop 中使用

要在 Claude Desktop 中使用此工具，请将以下内容添加到 claude_desktop_config.json：

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 .

许可证

此 MCP 服务基于 MIT 许可证授权。这意味着你可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。详情请参阅项目仓库中的 LICENSE 文件。

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。

GitHub MCP Server Plus

关于 GitHub MCP Server Plus

主要功能

适用场景

MCP 相关

配置

工具

详细介绍

GitHub MCP Server Plus

功能

工具

搜索查询语法

代码搜索

问题搜索

用户搜索

设置

个人访问令牌

在 Claude Desktop 中使用

Docker

NPX

构建

许可证

评论

第一次接触 MCP？

MCP（Model Context Protocol）是什么？

MCP 服务和客户端有什么区别？

本地服务与远程服务怎么选？

如何在 Claude、Cursor 等客户端中安装服务？

收录的项目经过审核吗？“认证”标识代表什么？

我维护的项目已被收录，怎样认领？