Server Github MCP (PR Comment)

Name: Server Github MCP (PR Comment)
Author: 195440

本地服务

github.com/195440版本控制074 周前更新

代码仓库

关于 Server Github MCP (PR Comment)

Server Github MCP (PR Comment) 将 GitHub API 操作提供给 MCP 客户端，用于仓库管理、搜索以及议题和拉取请求处理。它支持批量文件变更，并在保留 Git 历史的同时自动创建缺失的分支。

主要功能

01创建或更新单个及多个文件
02管理仓库、分支、议题和拉取请求
03搜索代码、仓库、议题和用户
04读取提交、文件、评审和状态检查
05保留 Git 历史且不强制推送

适用场景

01向仓库提交文件变更
02查找代码、仓库或 GitHub 用户
03创建并评审拉取请求
04跟踪和更新仓库议题

MCP 相关

它将 GitHub API 操作作为工具提供给 MCP 客户端，包括文件操作、搜索以及仓库和拉取请求管理。

#github #repository-management #api-integration

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "server-github": {
      "command": "npx",
      "args": [
        "-y",
        "@rz195440/server-github-mcp"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<GITHUB_PERSONAL_ACCESS_TOKEN>"
      }
    }
  }
}

启动命令npx -y @rz195440/server-github-mcp

需要配置的环境变量

GITHUB_PERSONAL_ACCESS_TOKEN密钥

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

安装包

npm@rz195440/server-github-mcpstdio

工具

收录的工具列表 · 更新于 3 周前

参数	类型	必填	说明
owner	string	是	仓库所有者（用户名或组织）
repo	string	是	仓库名称
path	string	是	创建或更新文件的路径
content	string	是	文件内容
message	string	是	提交消息
branch	string	是	要在其中创建或更新文件的分支
sha	string	否	要替换文件的 SHA（更新现有文件时必須）

详细介绍

GitHub MCP 服务

弃用通知： 此项目的开发已迁移至 GitHub，仓库地址为 https://github.com/195440/server-github-mcp。

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

功能

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

工具

create_or_update_file
- 在仓库中创建或更新单个文件
- 输入：
  - owner（string）：仓库所有者（用户名或组织）
  - repo（string）：仓库名称
  - path（string）：创建或更新文件的路径
  - content（string）：文件内容
  - message（string）：提交消息
  - branch（string）：创建或更新文件所在的分支
  - sha（可选的 string）：要替换的文件的 SHA（用于更新）
- 返回：文件内容和提交详情
push_files
- 在单次提交中推送多个文件
- 输入：
  - owner（string）：仓库所有者
  - repo（string）：仓库名称
  - branch（string）：要推送到的分支
  - files（array）：要推送的文件，每个文件包含 path 和 content
  - message（string）：提交消息
- 返回：更新后的分支引用
search_repositories
- 搜索 GitHub 仓库
- 输入：
  - query（string）：搜索查询
  - page（可选的 number）：分页页码
  - perPage（可选的 number）：每页结果数（最多 100）
- 返回：仓库搜索结果
create_repository
- 创建新的 GitHub 仓库
- 输入：
  - name（string）：仓库名称
  - description（可选的 string）：仓库描述
  - private（可选的 boolean）：是否将仓库设为私有
  - autoInit（可选的 boolean）：使用 README 初始化
- 返回：已创建的仓库详情
get_file_contents
- 获取文件或目录的内容
- 输入：
  - owner（string）：仓库所有者
  - repo（string）：仓库名称
  - path（string）：文件/目录路径
  - branch（可选的 string）：要从中获取内容的分支
- 返回：文件/目录内容
create_issue
- 创建新的议题
- 输入：
  - owner（string）：仓库所有者
  - repo（string）：仓库名称
  - title（string）：议题标题
  - body（可选的 string）：议题描述
  - assignees（可选的 string[]）：要指派的用户名
  - labels（可选的 string[]）：要添加的标签
  - milestone（可选的 number）：里程碑编号
- 返回：已创建的议题详情
create_pull_request
- 创建新的拉取请求
- 输入：
  - owner（string）：仓库所有者
  - repo（string）：仓库名称
  - title（string）：PR 标题
  - body（可选的 string）：PR 描述
  - head（string）：包含更改的分支
  - base（string）：要合并到的分支
  - draft（可选的 boolean）：创建为草稿 PR
  - maintainer_can_modify（可选的 boolean）：允许维护者编辑
- 返回：已创建的拉取请求详情
fork_repository
- 复刻仓库
- 输入：
  - owner（string）：仓库所有者
  - repo（string）：仓库名称
  - organization（可选的 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 (optional string)：页码
- per_page (optional string)：每页记录数
- sha (optional string)：分支名称
返回：提交记录列表

get_issue

获取仓库中某个问题的内容
输入：
- owner (string)：仓库所有者
- repo (string)：仓库名称
- issue_number (number)：要获取的问题编号
返回：GitHub Issue 对象及详情

get_pull_request

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

list_pull_requests

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

create_pull_request_review

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

merge_pull_request

合并拉取请求
输入：
- owner（字符串）：仓库所有者
- repo（字符串）：仓库名称
- pull_number（数字）：拉取请求编号
- commit_title（可选字符串）：合并提交的标题
- commit_message（可选字符串）：合并提交的补充说明
- merge_method（可选字符串）：合并方式（'merge'、'squash'、'rebase'）
返回：合并结果详情

get_pull_request_files

获取拉取请求中更改的文件列表
输入：
- owner（字符串）：仓库所有者
- repo（字符串）：仓库名称
- pull_number（数字）：拉取请求编号
返回：已更改文件的数组，包含补丁和状态详情

get_pull_request_status

获取拉取请求所有状态检查的综合状态
输入：
- owner（字符串）：仓库所有者
- repo（字符串）：仓库名称
- pull_number（数字）：拉取请求编号
返回：综合状态检查结果及各项检查详情

update_pull_request_branch

使用 base 分支的最新更改更新拉取请求分支（相当于 GitHub 的“更新分支”按钮）
输入：
- owner（字符串）：仓库所有者
- repo（字符串）：仓库名称
- pull_number（数字）：拉取请求编号
- expected_head_sha（可选字符串）：预期的拉取请求 HEAD 引用 SHA
返回：分支更新成功时的消息

get_pull_request_comments

获取拉取请求的评审评论
输入：
- owner（字符串）：仓库所有者
- repo（字符串）：仓库名称
- pull_number（数字）：拉取请求编号
返回：拉取请求评审评论数组，包含评论文本、作者和在差异中的位置等详情

get_pull_request_reviews

获取拉取请求的评审
输入：
- owner（字符串）：仓库所有者
- repo（字符串）：仓库名称
- pull_number（数字）：拉取请求编号
返回：拉取请求评审数组，包含评审状态（APPROVED、CHANGES_REQUESTED 等）、评审者和评审正文等详情

add_pr_summary_comment

向拉取请求添加摘要评论
输入：
- owner (string)：仓库所有者
- repo (string)：仓库名称
- pull_number (number)：拉取请求编号
- body (string)：评论文本
返回：已创建评论的详细信息

add_pr_line_comment

向拉取请求添加针对特定行的评论
输入：
- owner (string)：仓库所有者
- repo (string)：仓库名称

搜索查询语法

代码搜索

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

设置

个人访问令牌

创建具有相应权限的 GitHub 个人访问令牌：

前往个人访问令牌（位于 GitHub 设置 > 开发者设置中）
选择此令牌可访问的仓库（公开、全部或指定）
创建具有 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",
        "@rz195440/server-github-mcp"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

NPX

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@rz195440/server-github-mcp"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}"
      }
    }
  }
}

构建

Docker 构建：

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

许可证

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

支持 Markdown

登录后评论

第一次接触 MCP？

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

阅读入门指南

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