Github Pr MCP

🚀 GitHub PR 评论 MCP 服务器

这是一个借助 GitHub 私人访问令牌来获取 GitHub 拉取请求评论的模型上下文协议（MCP）服务器。它能有效帮助用户获取 PR 评论相关信息，为开发工作提供便利。

🚀 快速开始

安装

使用 Smithery 自动安装

要通过 Smithery 自动为 Claude Desktop 安装 github-pr-mcp，可执行以下命令：

npx -y @smithery/cli install github-pr-mcp --client claude

手动安装

1. 克隆仓库。
2. 安装依赖项：

npm install

3. 创建一个包含 GitHub 令牌的 .env 文件：

GITHUB_TOKEN=your_github_token_here

运行

1. 构建项目：

npm run build

2. 运行服务器：

npm start

或直接使用 GitHub 令牌运行：

node dist/server.js your_github_token_here

使用

服务器提供了一个名为 get_pr_comments 的工具，接受以下参数：

• owner: 仓库所有者（用户名或组织）
• repo: 仓库名称
• pull_number: 拉取请求编号

✨ 主要特性

• 获取包含文件路径、行范围和回复的 PR 评论。
• 使用 Octokit 调用 GitHub API。
• 实现 MCP 服务器，使用 StdioServerTransport。
• 返回结构化的 JSON 格式评论。

📦 安装指南

使用 Smithery 自动安装

npx -y @smithery/cli install github-pr-mcp --client claude

手动安装

1. 克隆仓库。
2. 安装依赖：

npm install

3. 创建 .env 文件并添加 GitHub 令牌：

GITHUB_TOKEN=your_github_token_here

💻 使用示例

基础用法

构建并运行服务器：

npm run build
npm start

或使用 GitHub 令牌直接运行：

node dist/server.js your_github_token_here

高级用法

调用 get_pr_comments 工具：

# 假设仓库所有者为 "owner", 仓库名称为 "repo", 拉取请求编号为 123
node dist/server.js your_github_token_here --owner owner --repo repo --pull_number 123

📚 详细文档

与 Cursor 集成

要将此服务器集成到 Cursor，请在 Cursor 的 MCP 服务器配置中使用以下命令：

node /path/to/dist/server.js your_github_token_here

请将 /path/to 替换为实际项目路径，并将 your_github_token_here 替换为你的 GitHub 个人访问令牌。

测试

包含一个测试客户端来验证服务器功能：

1. 构建项目：

npm run build

2. 运行测试客户端：

npm test

测试客户端将启动服务器，连接到它，并调用 get_pr_comments 工具，使用示例参数。

响应格式

服务器返回以下 JSON 格式评论：

{
  "comments": [
    {
      "id": 123456789,
      "path": "src/example.js",
      "body": "This is a comment on a specific line",
      "line": 42,
      "start_line": 40,
      "user": {
        "login": "username"
      },
      "created_at": "2023-01-01T00:00:00Z",
      "replies": [
        {
          "id": 987654321,
          "body": "This is a reply to the comment",
          "user": {
            "login": "another-username"
          },
          "created_at": "2023-01-02T00:00:00Z"
        }
      ]
    }
  ]
}

开发

以开发模式运行服务器：

npm run dev

📄 许可证

ISC