GerritレビューMCPサーバー

この MCP サーバーは Gerrit コードレビューシステムとの統合を提供し、AI アシスタントがシンプルなインターフェースを通じてコードの変更とその詳細をレビューできるようにします。

特徴

サーバーは、コードレビュー用の合理化されたツールセットを提供します。

変更の詳細を取得

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)

変更の2つのパッチセットの違いを比較する
特定のファイルの違いや変更されたすべてのファイルを表示する
パッチセットのバージョン間でコードの変更を分析する
レビューの反復を通じて変更の進行を追跡する

使用例

完全な変更を確認します。

# Fetch latest patchset of change 23824 change = fetch_gerrit_change("23824")

特定のパッチセットを比較します。

# Compare differences between patchsets 1 and 2 for change 23824 diff = fetch_patchset_diff("23824", "1", "2")

特定のファイルの変更を表示します。

# Get diff for a specific file between patchsets file_diff = fetch_patchset_diff("23824", "1", "2", "path/to/file.swift")

Related MCP server: CodeChecker MCP

前提条件

Python 3.10 以上 (Python 3.11 を推奨)
Gerrit HTTP アクセス資格情報
Gerrit設定から生成されたHTTPパスワード
mcp[cli]パッケージリポジトリへのアクセス（プライベートパッケージ）

インストール

このリポジトリをクローンします:

git clone <repository-url> cd gerrit-review-mcp

仮想環境を作成してアクティブ化します。

# For macOS/Linux: python -m venv .venv source .venv/bin/activate # For Windows: python -m venv .venv .venv\Scripts\activate

このパッケージを依存関係とともに編集可能モードでインストールします。

pip install -e .

構成

環境変数を設定します。

export GERRIT_HOST="gerrit.example.com" # Your Gerrit server hostname export GERRIT_USER="your-username" # Your Gerrit username export GERRIT_HTTP_PASSWORD="your-http-password" # Your Gerrit HTTP password

または、 .envファイルを作成します。

GERRIT_HOST=gerrit.example.com GERRIT_USER=your-username GERRIT_HTTP_PASSWORD=your-http-password

HTTPパスワードを生成します:

Gerritウェブインターフェースにログインする
設定 > HTTP認証情報に移動します
新しいパスワードを生成する
パスワードを環境または.envファイルにコピーします

MCP構成

このMCPサーバーをCursorで使用するには、 ~/.cursor/mcp.jsonファイルに設定を追加する必要があります。必要な設定は次のとおりです。

{ "mcpServers": { "gerrit-review-mcp": { "command": "/path/to/your/workspace/gerrit-code-review-mcp/.venv/bin/python", "args": [ "/path/to/your/workspace/gerrit-code-review-mcp/server.py", "--transport", "stdio" ], "cwd": "/path/to/your/workspace/gerrit-code-review-mcp", "env": { "PYTHONPATH": "/path/to/your/workspace/gerrit-code-review-mcp", "VIRTUAL_ENV": "/path/to/your/workspace/gerrit-code-review-mcp/.venv", "PATH": "/path/to/your/workspace/gerrit-code-review-mcp/.venv/bin:/usr/local/bin:/usr/bin:/bin" }, "stdio": true } } }

/path/to/your/workspace実際のワークスペースパスに置き換えてください。例えば、プロジェクトが/Users/username/projects/gerrit-code-review-mcpにある場合は、そのパスを使用してください。

構成内のすべてのパスが以下を指していることを確認します。

仮想環境のPythonインタープリタ
プロジェクトのserver.pyファイル
正しい作業ディレクトリ
PATH内の仮想環境のbinディレクトリ

実装の詳細

サーバーは Gerrit REST API を使用して Gerrit と対話し、次の機能を提供します。

高速かつ信頼性の高い変更情報検索
HTTPダイジェスト認証を使用した安全な認証
さまざまな Gerrit REST エンドポイントのサポート
クリーンで保守しやすいコードベース
安全な通信のためのHTTPS暗号化

トラブルシューティング

接続の問題が発生した場合:

HTTPパスワードが正しく設定されていることを確認してください
GERRIT_HOST設定を確認する
GerritサーバーでHTTPSアクセスが有効になっていることを確認する
curl を使用して接続をテストします。
curl -u "username:http-password" https://your-gerrit-host/a/changes/
アカウントの Gerrit アクセス権限を確認する