GitLab MCP Server

GitLab MCP Server

MCP-Server für die GitLab-API, der Projektmanagement, Dateivorgänge und mehr ermöglicht.

Merkmale

• Automatische Zweigerstellung : Beim Erstellen/Aktualisieren von Dateien oder beim Übertragen von Änderungen werden Zweige automatisch erstellt, wenn sie nicht vorhanden sind
• Umfassende Fehlerbehandlung : Klare Fehlermeldungen bei häufigen Problemen
• Erhaltung des Git-Verlaufs : Operationen bewahren den ordnungsgemäßen Git-Verlauf auf, ohne dass ein Force-Push erforderlich ist.
• Stapelverarbeitung : Unterstützung für Einzeldatei- und Mehrdateioperationen

Werkzeuge

1. create_or_update_file
   • Erstellen oder Aktualisieren einer einzelnen Datei in einem Projekt
   • Eingänge:
     • project_id (Zeichenfolge): Projekt-ID oder URL-codierter Pfad
     • file_path (Zeichenfolge): Pfad, in dem die Datei erstellt/aktualisiert werden soll
     • content (string): Inhalt der Datei
     • commit_message (Zeichenfolge): Commit-Nachricht
     • branch (Zeichenfolge): Branch zum Erstellen/Aktualisieren der Datei in
     • previous_path (optionale Zeichenfolge): Pfad der zu verschiebenden/umzubenennenden Datei
   • Gibt zurück: Dateiinhalt und Commit-Details
2. push_files
   • Pushen Sie mehrere Dateien in einem einzigen Commit
   • Eingänge:
     • project_id (Zeichenfolge): Projekt-ID oder URL-codierter Pfad
     • branch (Zeichenfolge): Zweig, zu dem gepusht werden soll
     • files (Array): Zu pushende Dateien, jeweils mit file_path und content
     • commit_message (Zeichenfolge): Commit-Nachricht
   • Rückgabe: Aktualisierte Zweigstellenreferenz
3. search_repositories
   • Suche nach GitLab-Projekten
   • Eingänge:
     • search (Zeichenfolge): Suchanfrage
     • page (optionale Zahl): Seitenzahl für die Paginierung
     • per_page (optionale Zahl): Ergebnisse pro Seite (Standard 20)
   • Rückgabe: Projektsuchergebnisse
4. create_repository
   • Erstellen Sie ein neues GitLab-Projekt
   • Eingänge:
     • name (Zeichenfolge): Projektname
     • description (optionale Zeichenfolge): Projektbeschreibung
     • visibility (optionale Zeichenfolge): „privat“, „intern“ oder „öffentlich“
     • initialize_with_readme (optionaler Boolescher Wert): Initialisieren mit README
   • Rückgabe: Erstellte Projektdetails
5. get_file_contents
   • Inhalte einer Datei oder eines Verzeichnisses abrufen
   • Eingänge:
     • project_id (Zeichenfolge): Projekt-ID oder URL-codierter Pfad
     • file_path (Zeichenfolge): Pfad zur Datei/zum Verzeichnis
     • ref (optionale Zeichenfolge): Branch/Tag/Commit, aus dem Inhalte abgerufen werden sollen
   • Rückgabe: Datei-/Verzeichnisinhalt
6. create_issue
   • Neues Problem erstellen
   • Eingänge:
     • project_id (Zeichenfolge): Projekt-ID oder URL-codierter Pfad
     • title (Zeichenfolge): Titel der Ausgabe
     • description (optionale Zeichenfolge): Problembeschreibung
     • assignee_ids (optional number[]): Zuzuweisende Benutzer-IDs
     • labels (optional string[]): Hinzuzufügende Labels
     • milestone_id (optionale Zahl): Meilenstein-ID
   • Retouren: Details zum erstellten Problem
7. create_merge_request
   • Erstellen einer neuen Zusammenführungsanforderung
   • Eingänge:
     • project_id (Zeichenfolge): Projekt-ID oder URL-codierter Pfad
     • title (Zeichenfolge): MR-Titel
     • description (optionale Zeichenfolge): MR-Beschreibung
     • source_branch (Zeichenfolge): Zweig mit Änderungen
     • target_branch (Zeichenfolge): Zweig, in den zusammengeführt werden soll
     • draft (optionaler Boolescher Wert): Als MR-Entwurf erstellen
     • allow_collaboration (optionaler Boolescher Wert): Erlaube Commits von Upstream-Mitgliedern
   • Rückgabe: Details der erstellten Zusammenführungsanforderung
8. fork_repository
   • Ein Projekt forken
   • Eingänge:
     • project_id (Zeichenfolge): Projekt-ID oder URL-codierter Pfad
     • namespace (optionale Zeichenfolge): Namespace, in den verzweigt werden soll
   • Rückgabe: Details zum gegabelten Projekt
9. create_branch
   • Erstellen Sie einen neuen Zweig
   • Eingänge:
     • project_id (Zeichenfolge): Projekt-ID oder URL-codierter Pfad
     • branch (Zeichenfolge): Name für neuen Zweig
     • ref (optionale Zeichenfolge): Quellzweig/Commit für neuen Zweig
   • Rückgabe: Erstellte Zweigreferenz

Aufstellen

Persönlicher Zugriffstoken

Erstellen Sie ein persönliches GitLab-Zugriffstoken mit entsprechenden Berechtigungen:

• Gehen Sie in GitLab zu Benutzereinstellungen > Zugriffstoken
• Wählen Sie die erforderlichen Bereiche aus:
  • api für vollständigen API-Zugriff
  • read_api für schreibgeschützten Zugriff
  • read_repository und write_repository für Repository-Operationen
• Erstellen Sie das Token und speichern Sie es sicher

Verwendung mit Claude Desktop

Fügen Sie Ihrer claude_desktop_config.json Folgendes hinzu:

Docker

NPX

Verwendung mit VS Code

Verwenden Sie für eine schnelle Installation eine der folgenden Ein-Klick-Installationsschaltflächen ...

Für die manuelle Installation fügen Sie den folgenden JSON-Block zu Ihrer Benutzereinstellungsdatei (JSON) in VS Code hinzu. Drücken Sie dazu Ctrl + Shift + P und geben Sie Preferences: Open User Settings (JSON) ein.

Optional können Sie es einer Datei namens .vscode/mcp.json in Ihrem Arbeitsbereich hinzufügen. Dadurch können Sie die Konfiguration mit anderen teilen.

Beachten Sie, dass der mcp Schlüssel in der Datei .vscode/mcp.json nicht benötigt wird.

Docker

NPX

Bauen

Docker-Build:

Umgebungsvariablen

• GITLAB_PERSONAL_ACCESS_TOKEN : Ihr persönlicher GitLab-Zugriffstoken (erforderlich)
• GITLAB_API_URL : Basis-URL für die GitLab-API (optional, standardmäßig https://gitlab.com/api/v4 )

Lizenz

Dieser MCP-Server ist unter der MIT-Lizenz lizenziert. Das bedeutet, dass Sie die Software unter den Bedingungen der MIT-Lizenz frei verwenden, ändern und verbreiten dürfen. Weitere Informationen finden Sie in der LICENSE-Datei im Projekt-Repository.