mcp-gh-pr-mini

mcp-gh-pr-mini

site icon
2025.04.08 0
JavaScriptGitHub 交互代码审阅团队协作开发效率交流协作
mcp-gh-pr-mini 是一个基于 MCP(Model Context Protocol)的 GitHub 拉取请求(Pull Request)交互工具。它提供了一系列核心功能,帮助开发者通过 MCP 协议与 GitHub 的拉取请求进行交互,包括创建、列表、查看差异、请求审阅者以及评论等功能。该工具设计简洁,易于理解,适合作为构建 MCP 服务器的参考。
View on GitHub

Overview

基本能力

产品定位

mcp-gh-pr-mini 是一个专注于 GitHub 拉取请求交互的 MCP 服务器,旨在简化开发者与 GitHub PR 的交互流程。

核心功能

  • 创建拉取请求:在 GitHub 仓库中创建新的拉取请求。
  • 列表拉取请求:列出当前仓库中所有开放的拉取请求。
  • 查看差异:获取拉取请求的差异内容。
  • 请求审阅者:为拉取请求指定审阅者。
  • 评论功能
  • 添加评论,自动标记为 "[AI] Generated using MCP" 以便识别。
  • 支持普通 PR 评论和针对特定代码位置的审阅评论。
  • 获取评论:从拉取请求中获取所有评论。
  • 获取文件变更
  • 获取变更文件的详细信息。
  • 提供审阅评论的位置信息。
  • 显示每个文件的添加、删除和补丁信息。

适用场景

  • 代码审阅:通过 MCP 协议自动化代码审阅流程。
  • 团队协作:简化团队成员之间的代码审阅和反馈流程。
  • 开发工具集成:与 VSCode 等开发工具集成,提升开发效率。

使用教程

使用依赖

  • Node.js:确保已安装 Node.js。
  • VSCode:安装支持 MCP 的扩展(如 Copilot Agent)。

安装教程

  1. 在 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}"
      }
    }
  }
}
  1. 替换 {Your Fine-Grained GitHub Token} 为你的 GitHub 个人访问令牌。

调试方式

  • 确保 GITHUB_PERSONAL_ACCESS_TOKEN 具有以下权限:
  • 拉取请求:读写权限。
  • 问题:读写权限。
  • 内容:读写权限。
  • 运行 npx mcp-gh-pr-mini 启动服务器。
  • 在 VSCode 中使用 MCP 兼容客户端进行交互。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。