GitHub MCP Server

Name: GitHub MCP Server
Author: kich555

本地服务

github.com/kich555版本控制081 周前更新

代码仓库

关于 GitHub MCP Server

GitHub MCP Server 将 GitHub API 操作提供给需要处理仓库、议题、拉取请求和搜索的用户。它支持批量文件更新，并在修改时保留 Git 历史。

主要功能

01创建和更新仓库文件
02在单次提交中推送多个文件
03管理仓库、分支和派生仓库
04创建和管理议题与拉取请求
05搜索仓库、代码、议题和用户
06获取提交、评审和拉取请求详情

适用场景

01更新仓库中的多个文件
02搜索 GitHub 代码或议题
03评审并合并拉取请求
04创建仓库并管理分支

MCP 相关

它向 MCP 客户端提供 GitHub API 工具，包括仓库、文件、议题、拉取请求和搜索操作。

#github #mcp-server #api

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "github-mcp-server-kich555": {
      "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 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。