返回 MCP 目录
public公开dns本地运行

mcp-gh-pr-mini

一个用于GitHub拉取请求交互的MCP服务器

article

README

🚀 mcp-gh-pr-mini

mcp-gh-pr-mini 是一个最小化的MCP(模型上下文协议)服务器,用于与GitHub拉取请求进行交互。借助它,你可以通过MCP在GitHub仓库中轻松创建、列出拉取请求,查看diff,请求评论者,还能对拉取请求进行评论。

🚀 快速开始

此工具作为MCP服务器在本地环境运行,可搭配Copilot Agent或其他兼容MCP客户端使用。

先决条件

  • 安装Node.js
  • 在VSCode中安装兼容MCP扩展(例如Copilot Agent)

配置 settings.json

在VSCode的settings.json文件中添加以下内容:

"mcp": {
  "servers": {
    "mcp-gh-pr-mini": {
      "command": "npx",
      "args": ["mcp-gh-pr-mini"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "{Your Fine-grained GitHub Token}"
      }
    }
  }
}

✨ 主要特性

  • 创建拉取请求:可在GitHub仓库中创建拉取请求。
  • 列出拉取请求:列出仓库中所有打开的拉取请求。
  • 查看diff:获取拉取请求的diff信息。
  • 请求评论者:为拉取请求请求评论者。
  • 评论拉取请求
    • 评论会自动以“[AI] 使用MCP生成”进行标记,便于识别。
    • 支持一般的PR评论和针对代码特定位置的审查评论。
  • 获取评论:获取拉取请求中的评论。
  • 获取文件更改信息
    • 检索有关更改文件的详细信息。
    • 提供添加审查评论的位置。
    • 显示每个文件的添加、删除和补丁信息。

🔐 令牌权限

💡 使用建议

使用带有以下权限的细粒度GitHub个人访问令牌:

  • 拉取请求:读写
  • 问题:读写
  • 内容:读写

🤔 为什么选择它?

该项目提供了一个最小化、专注实现核心拉取请求任务的MCP服务器。其设计简单易懂,是构建MCP服务器的良好参考。

🙏 感谢

我刚开始接触构建MCP服务器,因此可能存在改进的空间。随时欢迎反馈、建议和贡献!

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端