Gerrit Code Review

🚀 Gerrit 代碼審查 MCP 服務器

此 MCP 服務器提供了與 Gerrit 代碼審查系統集成的功能，允許 AI 助手通過簡單的接口查看和評估代碼變更及其詳細信息，極大地提升了代碼審查的效率和便捷性。

🚀 快速開始

此 MCP 服務器提供了與 Gerrit 代碼審查系統集成的功能，允許 AI 助手通過簡單的接口查看和評估代碼變更及其詳細信息。在使用前，請確保滿足以下先決條件：

1. 安裝 Python 3.8 或更高版本。
2. 確保 Gerrit 服務器已啟用 HTTPS 訪問。
3. 配置正確的 HTTP 憑證以訪問 Gerrit REST API。

✨ 主要特性

該服務器提供了一套精簡的代碼審查工具：

獲取變更詳情

fetch_gerrit_change(change_id: str, patchset_number: Optional[str] = None)

• 獲取完整的變更信息，包括文件和補丁集。
• 顯示每個修改文件的詳細差異信息。
• 展示文件更改、插入和刪除。
• 支持查看特定補丁集。
• 返回全面的變更詳情，涵蓋項目和分支信息、作者和審閱者信息、評論和審查歷史記錄、文件修改內容及差異、當前補丁集信息。

比較補丁集差異

fetch_patchset_diff(change_id: str, base_patchset: str, target_patchset: str, file_path: Optional[str] = None)

• 比較兩個補丁集之間的差異。
• 查看特定文件的差異或所有更改文件。
• 分析代碼修改在補丁集版本中的演變。
• 跟蹤審查迭代中的變更發展。

📦 安裝指南

通過 Smithery

使用以下命令安裝和管理此包：

smith install @cayirtepeomer/gerrit-code-review-mcp

手動安裝

1. 克隆倉庫：

   git clone https://github.com/cayirtepeomer/gerrit-code-review-mcp.git
   cd gerrit-code-review-mcp
   

2. 安裝依賴項：

   pip install -r requirements.txt
   

💻 使用示例

基礎用法

審查完整的變更：

# 獲取變更 23824 的最新補丁集
change = fetch_gerrit_change("23824")

高級用法

比較特定的補丁集

# 比較變更 23824 中補丁集 1 和 2 的差異
diff = fetch_patchset_diff("23824", "1", "2")

獲取某個文件在兩個補丁集之間的具體變化

# 獲取 change_id 下 file_path 文件在 base 到 target 補丁集的修改內容
content_diff = fetch_patchset_diff(change_id, base, target, file_path=file_path)

📚 詳細文檔

配置步驟

環境變量設置

在項目的根目錄下創建一個 .env 文件，並添加以下內容：

GERRIT_HOST=your-gerrit-host
GERRIT_USERNAME=username
GERRIT_HTTP_PASSWORD=http-password

將 your-gerrit-host 替換為您的 Gerrit 服務器地址，例如：https://gerrit.example.com

MCP 配置

在項目的根目錄下創建或修改 config.json 文件，並添加以下內容：

{
  "servers": {
    "gerrit-code-review-mcp": {
      "host": "localhost",
      "port": 8080,
      "ssl": false,
      "auth": {
        "type": "digest",
        "username": "your-username",
        "password": "your-http-password"
      }
    }
  }
}

故障排除

如果遇到連接問題：

1. 確保 HTTP 密碼設置正確。
2. 檢查 GERRIT_HOST 設置。
3. 確保 Gerrit 服務器啟用了 HTTPS 訪問。
4. 使用 curl 測試連接：

   curl -u "username:http-password" https://your-gerrit-host/a/changes/
   

5. 確認您的賬戶在 Gerrit 上有訪問權限。

🔧 技術細節

該服務器使用 Gerrit REST API 進行交互，具備以下特點：

• 快速可靠的變更信息檢索。
• 使用 HTTP 摘要認證的安全性。
• 支持多種 Gerrit REST 終端點。
• 清潔且易於維護的代碼庫。
• HTTPS 加密以確保通信安全。

📄 許可證

此項目採用 MIT 許可證。

貢獻指南

我們歡迎任何貢獻！請按照以下步驟操作：

1. 叉取倉庫。
2. 創建功能分支。
3. 進行修改。
4. 提交拉取請求。