Gerrit Review MCP-Server

Name: Gerrit Review MCP Server
Author: cayirtepeomer

Schmiedeabzeichen

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: CodeChecker MCP

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

Klonen Sie dieses Repository:

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

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

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

pip install -e .

Konfiguration

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

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:

Überprüfen Sie, ob Ihr HTTP-Passwort richtig eingestellt ist
Überprüfen Sie die GERRIT_HOST-Einstellung
Stellen Sie sicher, dass der HTTPS-Zugriff auf dem Gerrit-Server aktiviert ist
Testen Sie die Verbindung mit curl:
curl -u "username:http-password" https://your-gerrit-host/a/changes/
Ü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:

Forken Sie das Repository
Erstellen eines Feature-Zweigs
Nehmen Sie Ihre Änderungen vor
Senden einer Pull-Anfrage

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Gerrit Review MCP Server