Gerrit Review MCP-Server

Dieser MCP-Server bietet eine Integration mit dem Codeüberprüfungssystem Gerrit, sodass KI-Assistenten Codeänderungen und deren Details über eine einfache Schnittstelle überprüfen können.

Merkmale

Der Server bietet einen optimierten Satz an Tools zur Codeüberprüfung:

Änderungsdetails abrufen

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

• Holt vollständige Änderungsinformationen einschließlich Dateien und Patch-Sets

• Zeigt detaillierte Diff-Informationen für jede geänderte Datei an

• Zeigt Dateiänderungen, Einfügungen und Löschungen an

• Unterstützt die Überprüfung bestimmter Patch-Sets

• Gibt umfassende Änderungsdetails zurück, einschließlich:

  • Projekt- und Brancheninformationen

  • Angaben zu Autor und Gutachter

  • Kommentare und Bewertungsverlauf

  • Dateiänderungen mit Diff-Inhalten

  • Aktuelle Patch-Set-Informationen

Vergleichen Sie die Unterschiede zwischen den Patchsets

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

• Vergleichen Sie die Unterschiede zwischen zwei Patchsets einer Änderung

• Anzeigen bestimmter Dateiunterschiede oder aller geänderten Dateien

• Analysieren Sie Codeänderungen über Patchset-Versionen hinweg

• Verfolgen Sie die Entwicklung von Änderungen durch Überprüfungsiterationen

Beispielverwendung

Überprüfen Sie eine vollständige Änderung:

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

Vergleichen Sie bestimmte Patchsets:

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

Bestimmte Dateiänderungen anzeigen:

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

Related MCP server: Phabricator MCP Server

Voraussetzungen

• Python 3.10 oder höher (Python 3.11 empfohlen)

• Gerrit-HTTP-Zugriffsdaten

• Aus den Gerrit-Einstellungen generiertes HTTP-Passwort

• Zugriff auf das mcp[cli] -Paket-Repository (privates Paket)

Installation

Installation über Smithery

So installieren Sie gerrit-code-review-mcp für Claude Desktop automatisch über Smithery :

npx -y @smithery/cli install @cayirtepeomer/gerrit-code-review-mcp --client claude

Manuelle Installation

1. Klonen Sie dieses Repository:

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

2. Erstellen und aktivieren Sie eine virtuelle Umgebung:

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

# For Windows:
python -m venv .venv
.venv\Scripts\activate

3. Installieren Sie dieses Paket im bearbeitbaren Modus mit seinen Abhängigkeiten:

pip install -e .

Konfiguration

1. Umgebungsvariablen einrichten:

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

Oder erstellen Sie eine .env Datei:

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

2. HTTP-Passwort generieren:

• Melden Sie sich bei Ihrer Gerrit-Weboberfläche an

• Gehen Sie zu Einstellungen > HTTP-Anmeldeinformationen

• Neues Passwort generieren

• Kopieren Sie das Passwort in Ihre Umgebung oder .env-Datei

MCP-Konfiguration

Um diesen MCP-Server mit Cursor zu verwenden, müssen Sie seine Konfiguration zu Ihrer Datei ~/.cursor/mcp.json hinzufügen. Hier ist die erforderliche Konfiguration:

{
  "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
    }
  }
}

Ersetzen Sie /path/to/your/workspace durch Ihren tatsächlichen Arbeitsbereichspfad. Wenn sich Ihr Projekt beispielsweise unter /Users/username/projects/gerrit-code-review-mcp befindet, verwenden Sie stattdessen diesen Pfad.

Stellen Sie sicher, dass alle Pfade in der Konfiguration auf Folgendes verweisen:

• Der Python-Interpreter Ihrer virtuellen Umgebung

• Die server.py Datei des Projekts

• Das richtige Arbeitsverzeichnis

• Das Bin-Verzeichnis der virtuellen Umgebung im PATH

Implementierungsdetails

Der Server verwendet die Gerrit REST API zur Interaktion mit Gerrit und bietet:

• Schnelles und zuverlässiges Abrufen von Änderungsinformationen

• Sichere Authentifizierung mit HTTP Digest Auth

• Unterstützung für verschiedene Gerrit REST-Endpunkte

• Saubere und wartbare Codebasis

• HTTPS-Verschlüsselung für sichere Kommunikation

Fehlerbehebung

Wenn Verbindungsprobleme auftreten:

1. Überprüfen Sie, ob Ihr HTTP-Passwort richtig eingestellt ist

2. Überprüfen Sie die GERRIT_HOST-Einstellung

3. Stellen Sie sicher, dass der HTTPS-Zugriff auf dem Gerrit-Server aktiviert ist

4. Testen Sie die Verbindung mit curl:

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

5. Überprüfen Sie die Gerrit-Zugriffsberechtigungen für Ihr Konto

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.

Beitragen

Wir freuen uns über Beiträge! Bitte:

1. Forken Sie das Repository

2. Erstellen eines Feature-Zweigs

3. Nehmen Sie Ihre Änderungen vor

4. Senden einer Pull-Anfrage