GitHub MCP Server

Name: GitHub MCP Server
Author: AlexKissiJr

本地服务

github.com/AlexKissiJr版本控制084 周前更新

代码仓库

关于 GitHub MCP Server

GitHub MCP Server 为开发者和 Agent 提供 GitHub API 操作，涵盖仓库文件、议题、拉取请求和搜索。支持批量文件变更，并可按需自动创建分支。

主要功能

01读取和写入仓库文件
02批量提交文件
03创建仓库和分支
04管理议题和拉取请求
05搜索代码、仓库、议题和用户
06保留 Git 历史且不强制推送

适用场景

01更新一个或多个仓库文件
02创建和跟踪议题
03审查并合并拉取请求
04查找代码、仓库或用户

MCP 相关

它向 MCP 客户端提供 GitHub API 工具，用于仓库管理、文件操作、议题与拉取请求流程以及搜索。

配置

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

mcp.json · 通用配置

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

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

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

安装包

ocibuildstdio

工具

还没有获取到工具列表

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

详细介绍

GitHub MCP 服务

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

功能

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

工具

create_or_update_file
- 在仓库中创建或更新单个文件
- 输入：
  - owner（字符串）：仓库所有者（用户名或组织）
  - repo（字符串）：仓库名称
  - path（字符串）：创建或更新文件的路径
  - content（字符串）：文件内容
  - message（字符串）：提交消息
  - branch（字符串）：创建或更新文件所在的分支
  - sha（可选字符串）：要替换文件的 SHA（用于更新）
- 返回：文件内容和提交详情
push_files
- 在一次提交中推送多个文件
- 输入：
  - owner（字符串）：仓库所有者
  - repo（字符串）：仓库名称
  - branch（字符串）：要推送到的分支
  - files（数组）：要推送的文件，每个文件包含 path 和 content
  - message（字符串）：提交消息
- 返回：更新后的分支引用
search_repositories
- 搜索 GitHub 仓库
- 输入：
  - query（字符串）：搜索查询
  - page（可选数字）：分页页码
  - perPage（可选数字）：每页结果数（最多 100）
- 返回：仓库搜索结果
create_repository
- 创建新的 GitHub 仓库
- 输入：
  - name（字符串）：仓库名称
  - description（可选字符串）：仓库描述
  - private（可选布尔值）：仓库是否应设为私有
  - autoInit（可选布尔值）：使用 README 初始化
- 返回：已创建的仓库详情
get_file_contents
- 获取文件或目录的内容
- 输入：
  - owner（字符串）：仓库所有者
  - repo（字符串）：仓库名称
  - path（字符串）：文件/目录路径
  - branch（可选字符串）：要从中获取内容的分支
- 返回：文件/目录内容
create_issue
- 创建新的议题
- 输入：
  - owner（字符串）：仓库所有者
  - repo（字符串）：仓库名称
  - title（字符串）：议题标题
  - body（可选字符串）：议题描述
  - assignees（可选字符串数组）：要指派的用户名
  - labels（可选字符串数组）：要添加的标签
  - milestone（可选数字）：里程碑编号
- 返回：已创建的议题详情
create_pull_request
- 创建新的拉取请求
- 输入：
  - owner（字符串）：仓库所有者
  - repo（字符串）：仓库名称
  - title（字符串）：PR 标题
  - body（可选字符串）：PR 描述
  - head（字符串）：包含更改的分支
  - base（字符串）：要合并到的分支
  - draft（可选布尔值）：创建为草稿 PR
  - maintainer_can_modify（可选布尔值）：允许维护者编辑
- 返回：已创建的拉取请求详情
fork_repository
- 复刻仓库
- 输入：
  - owner（字符串）：仓库所有者
  - repo（字符串）：仓库名称
  - organization（可选字符串）：要复刻到的组织
- 返回：已复刻的仓库详情
create_branch
- 创建新分支
- 输入：
  - owner（字符串）：仓库所有者
  - repo（字符串）：仓库名称
  - branch（字符串）：新分支的名称
  - from_branch（可选字符串）：源分支（默认为仓库的默认分支）
- 返回：已创建的分支引用
list_issues
- 列出并筛选仓库问题
- 输入：
  - owner（字符串）：仓库所有者
  - repo（字符串）：仓库名称
  - state（可选字符串）：按状态筛选（'open'、'closed'、'all'）
  - labels（可选字符串数组）：按标签筛选
  - sort（可选字符串）：按（'created'、'updated'、'comments'）排序
  - direction（可选字符串）：排序方向（'asc'、'desc'）
  - since（可选字符串）：按日期筛选（ISO 8601 时间戳）
  - page（可选数字）：页码
  - per_page（可选数字）：每页结果数
- 返回：问题详情数组
update_issue
- 更新现有问题
- 输入：
  - owner（字符串）：仓库所有者
  - repo（字符串）：仓库名称
  - issue_number（数字）：要更新的问题编号
  - title（可选字符串）：新标题
  - body（可选字符串）：新描述
  - state（可选字符串）：新状态（'open' 或 'closed'）
  - labels（可选字符串数组）：新标签
  - assignees（可选字符串数组）：新指派对象
  - milestone（可选数字）：新里程碑编号
- 返回：已更新的问题详情
add_issue_comment
- 为问题添加评论
- 输入：
  - owner（字符串）：仓库所有者
  - repo（字符串）：仓库名称
  - issue_number（数字）：要评论的问题编号
  - body（字符串）：评论内容
- 返回：已创建的评论详情
search_code
- 在 GitHub 仓库中搜索代码
- 输入：
  - q（字符串）：使用 GitHub 代码搜索语法的搜索查询
  - sort（可选字符串）：排序字段（仅限 'indexed'）
  - order（可选字符串）：排序顺序（'asc' 或 'desc'）
  - per_page（可选数字）：每页结果数（最多 100）
  - page（可选数字）：页码
- 返回：包含仓库上下文的代码搜索结果
search_issues
- 搜索问题和拉取请求
- 输入：
  - q（字符串）：使用 GitHub 问题搜索语法的搜索查询
  - sort（可选字符串）：排序字段（comments、reactions、created 等）
  - order（可选字符串）：排序顺序（'asc' 或 'desc'）
  - per_page（可选数字）：每页结果数（最多 100）
  - page（可选数字）：页码
- 返回：问题和拉取请求搜索结果
search_users
- 搜索 GitHub 用户
- 输入：
  - q（字符串）：使用 GitHub 用户搜索语法的搜索查询
  - sort（可选字符串）：排序字段（followers、repositories、joined）
  - order（可选字符串）：排序顺序（'asc' 或 'desc'）
  - per_page（可选数字）：每页结果数（最多 100）
  - page（可选数字）：页码
- 返回：用户搜索结果
list_commits

获取仓库分支的提交记录
输入：
- owner（字符串）：仓库所有者
- repo（字符串）：仓库名称
- page（可选字符串）：页码
- per_page（可选字符串）：每页记录数
- sha（可选字符串）：分支名称
返回：提交记录列表

get_issue

获取仓库中某个问题的内容
输入：
- owner（字符串）：仓库所有者
- repo（字符串）：仓库名称
- issue_number（数字）：要获取的问题编号
返回：Github Issue 对象及详情

get_pull_request

获取特定拉取请求的详情
输入：
- owner（字符串）：仓库所有者
- repo（字符串）：仓库名称
- pull_number（数字）：拉取请求编号
返回：拉取请求详情，包括差异和审查状态

list_pull_requests

列出并筛选仓库拉取请求
输入：
- owner (string)：仓库所有者
- repo (string)：仓库名称
- state (optional string)：按状态筛选（'open'、'closed'、'all'）
- head (optional string)：按头部分支的用户/组织和分支筛选
- base (optional string)：按基分支筛选
- sort (optional string)：按（'created'、'updated'、'popularity'、'long-running'）排序
- direction (optional string)：排序方向（'asc'、'desc'）
- per_page (optional number)：每页结果数（最多 100）
- page (optional number)：页码
返回：拉取请求详情数组

create_pull_request_review

在拉取请求上创建评审
输入：
- owner (string)：仓库所有者
- repo (string)：仓库名称
- pull_number (number)：拉取请求编号
- body (string)：评审评论文本
- event (string)：评审操作（'APPROVE'、'REQUEST_CHANGES'、'COMMENT'）
- commit_id (optional string)：要评审的提交 SHA
- comments (optional array)：针对特定行的评论，每条包含：
  - path (string)：文件路径
  - position (number)：差异中的行位置
  - body (string)：评论文本
返回：已创建的评审详情

merge_pull_request

合并拉取请求
输入：
- owner (string)：仓库所有者
- repo (string)：仓库名称
- pull_number (number)：拉取请求编号
- commit_title (optional string)：合并提交的标题
- commit_message (optional string)：合并提交的补充说明
- merge_method (optional 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

使用基分支中的最新变更更新拉取请求分支（相当于 GitHub 的“更新分支”按钮）
输入：
- owner (string)：仓库所有者
- repo (string)：仓库名称
- pull_number (number)：拉取请求编号
- expected_head_sha (optional 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)：拉取请求编号
返回：拉取请求评审数组，包含评审状态（APPROVED、CHANGES_REQUESTED 等）、评审者和评审内容等详情

搜索查询语法

代码搜索

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

Issues 搜索

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 搜索文档。

设置

Personal Access Token

创建 GitHub Personal Access Token，并授予适当的权限：

前往 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 License 授权。这意味着你可以自由使用、修改和分发该软件，但须遵守 MIT License 的条款和条件。详情请参阅项目仓库中的 LICENSE 文件。

支持 Markdown

登录后评论

第一次接触 MCP？

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

阅读入门指南

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