Gerrit Code Review

🚀 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つのパッチセット間の差分を比較します。
• 特定のファイルの差分またはすべての変更ファイルを閲覧します。
• パッチセットバージョンにおけるコード変更の進化を分析します。
• レビューイテレーション中の変更の進展を追跡します。

💻 使用例

基本的な使用法

完全な変更をレビューする例：

# 変更 23824 の最新パッチセットを取得
change = fetch_gerrit_change("23824")

高度な使用法

特定のパッチセットを比較する例：

# 変更 23824 のパッチセット 1 と 2 の差分を比較
diff = fetch_patchset_diff("23824", "1", "2")

あるファイルの2つのパッチセット間の具体的な変更を取得する例：

# change_id 下の file_path ファイルの base から target パッチセットの変更内容を取得
content_diff = fetch_patchset_diff(change_id, base, target, file_path=file_path)

📦 インストール

前提条件

1. Python 3.8 以上をインストールします。
2. Gerrit サーバが HTTPS アクセスを有効にしていることを確認します。
3. Gerrit REST API にアクセスするための正しい HTTP 認証情報を設定します。

インストール方法

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
   

📚 ドキュメント

環境変数の設定

プロジェクトのルートディレクトリに .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"
      }
    }
  }
}

🔧 技術詳細

このサーバは Gerrit REST API を使用して通信し、以下の機能を提供します。

• 高速かつ信頼性の高い変更情報の検索
• HTTP ダイジェスト認証によるセキュリティ
• 複数の Gerrit REST エンドポイントのサポート
• クリーンで保守しやすいコードベース
• 通信のセキュリティを確保するための HTTPS 暗号化

トラブルシューティング

接続問題が発生した場合：

1. HTTP パスワードが正しく設定されていることを確認します。
2. GERRIT_HOST 設定を確認します。
3. Gerrit サーバが HTTPS アクセスを有効にしていることを確認します。
4. curl を使用して接続をテストします。

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

5. あなたのアカウントが Gerrit 上でアクセス権限を持っていることを確認します。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。

コントリビューションガイド

どんなコントリビューションも歓迎します！以下の手順に従ってください。

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更を加えます。
4. プルリクエストを送信します。