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