Code Reviewer MCP

🚀 代碼審查 MCP 服務器

本項目是一個使用 Model Context Protocol 的 GitHub 拉取請求代碼審查服務器，它集成了 OpenRouter 的 AI 模型，能夠自動化進行代碼審查並提供詳細反饋，助力開發者提升代碼質量。

🚀 快速開始

本服務器可實現自動化的 GitHub 拉取請求代碼審查，為開發者提供代碼質量、風格及潛在問題的詳細反饋，同時支持全面的日誌記錄，方便調試。

要求

• GitHub 個人訪問令牌 (PAT)：具有 repo 權限以訪問私有倉庫，或 public_repo 權限以訪問公開倉庫。此令牌用於獲取拉取請求數據。
• OpenRouter API 密鑰

安裝

1. 克隆此倉庫：

git clone https://github.com/joaomj/code-reviewer-mcp.git
cd code-reviewer-mcp

2. 安裝依賴項：

npm install

3. 設置必要的環境變量：

export GITHUB_PAT=your_github_personal_access_token
export OPENROUTER_API_KEY=your_openrouter_api_key

4. 構建服務器：

npm run build

使用

啟動 MCP 服務器：

node build/index.js

該服務器可供任何 MCP 兼容客戶端（如 Claude Desktop）使用。

配置

在您的 MCP 客戶端配置中添加以下內容：

{
  "mcpServers": {
    "code-reviewer-mcp": {
      "command": "node",
      "args": ["/path/to/code-reviewer-mcp/build/index.js"],
      "env": {
        "GITHUB_PAT": "your_github_token",
        "OPENROUTER_API_KEY": "your_openrouter_key"
      }
    }
  }
}

✨ 主要特性

• 自動化 GitHub 拉取請求代碼審查，提高審查效率。
• 提供詳細的代碼質量、風格及潛在問題反饋，幫助開發者優化代碼。
• 集成 OpenRouter 的 AI 模型（目前使用 Gemini 2.5 Pro），藉助 AI 能力提升審查準確性。
• 全面的日誌記錄用於調試，方便排查問題。

📦 安裝指南

克隆倉庫

git clone https://github.com/joaomj/code-reviewer-mcp.git
cd code-reviewer-mcp

安裝依賴

npm install

設置環境變量

export GITHUB_PAT=your_github_personal_access_token
export OPENROUTER_API_KEY=your_openrouter_api_key

構建服務器

npm run build

💻 使用示例

基礎用法

啟動 MCP 服務器：

node build/index.js

高級用法

在 MCP 客戶端配置中添加服務器信息，實現客戶端與服務器的集成：

{
  "mcpServers": {
    "code-reviewer-mcp": {
      "command": "node",
      "args": ["/path/to/code-reviewer-mcp/build/index.js"],
      "env": {
        "GITHUB_PAT": "your_github_token",
        "OPENROUTER_API_KEY": "your_openrouter_key"
      }
    }
  }
}

📚 詳細文檔

開發

• 使用自動重建：

npm run watch

• 運行測試：

npm test

調試

內置日誌輸出到 stderr，提供詳細的調試信息，包括：

• GitHub API 請求
• OpenRouter API 調用
• 處理步驟
• 任何遇到的錯誤

高級調試可使用 MCP 檢查器：

npm run inspector

下一步計劃

未來改進和功能：

• [ ] 草稿拉取請求分析
• [ ] 自定義審查模板
• [ ] 支持多個 AI 模型（OpenAI、Claude 等）
• [ ] 文件特定反饋
• [ ] 速率限制與緩存

貢獻

歡迎提出建議。請先打開問題討論您希望更改的內容。

🔧 技術細節

目前該服務器主要依賴 GitHub 個人訪問令牌和 OpenRouter API 密鑰，通過集成 OpenRouter 的 AI 模型（如 Gemini 2.5 Pro）實現代碼審查功能。在運行過程中，會進行全面的日誌記錄，方便調試和排查問題。

📄 許可證

文檔未提及相關信息。

⚠️ 重要提示

目前該服務器僅支持開放的拉取請求（不支持草稿 PR）。