mcp-server-git: Ein Git-MCP-Server

Überblick

Ein Model Context Protocol-Server für die Interaktion und Automatisierung von Git-Repositorys. Dieser Server bietet Tools zum Lesen, Durchsuchen und Bearbeiten von Git-Repositorys über Large Language Models.

Bitte beachten Sie, dass sich mcp-server-git derzeit in der frühen Entwicklungsphase befindet. Die Funktionalität und die verfügbaren Tools können sich im Zuge der Weiterentwicklung und Verbesserung des Servers ändern und erweitern.

Werkzeuge

1. git_status

   • Zeigt den Status des Arbeitsbaums an

   • Eingang:

     • repo_path (Zeichenfolge): Pfad zum Git-Repository

   • Rückgabe: Aktueller Status des Arbeitsverzeichnisses als Textausgabe

2. git_diff_unstaged

   • Zeigt Änderungen im Arbeitsverzeichnis an, die noch nicht bereitgestellt wurden

   • Eingang:

     • repo_path (Zeichenfolge): Pfad zum Git-Repository

   • Gibt zurück: Diff-Ausgabe nicht bereitgestellter Änderungen

3. git_diff_staged

   • Zeigt Änderungen an, die für das Commit vorbereitet sind

   • Eingang:

     • repo_path (Zeichenfolge): Pfad zum Git-Repository

   • Gibt zurück: Diff-Ausgabe der stufenweisen Änderungen

4. git_diff

   • Zeigt Unterschiede zwischen Zweigen oder Commits

   • Eingänge:

     • repo_path (Zeichenfolge): Pfad zum Git-Repository

     • target (Zeichenfolge): Zielzweig oder Commit zum Vergleichen

   • Gibt zurück: Diff-Ausgabe, die den aktuellen Status mit dem Ziel vergleicht

5. git_commit

   • Protokolliert Änderungen am Repository

   • Eingänge:

     • repo_path (Zeichenfolge): Pfad zum Git-Repository

     • message (Zeichenfolge): Commit-Nachricht

   • Rückgabe: Bestätigung mit neuem Commit-Hash

6. git_add

   • Fügt Dateiinhalte zum Staging-Bereich hinzu

   • Eingänge:

     • repo_path (Zeichenfolge): Pfad zum Git-Repository

     • files (Zeichenfolge[]): Array von Dateipfaden zur Bereitstellung

   • Rückgabe: Bestätigung der bereitgestellten Dateien

7. git_reset

   • Hebt die Bereitstellung aller bereitgestellten Änderungen auf

   • Eingang:

     • repo_path (Zeichenfolge): Pfad zum Git-Repository

   • Rückgabe: Bestätigung des Rücksetzvorgangs

8. git_log

   • Zeigt die Commit-Logs

   • Eingänge:

     • repo_path (Zeichenfolge): Pfad zum Git-Repository

     • max_count (Zahl, optional): Maximale Anzahl der anzuzeigenden Commits (Standard: 10)

   • Rückgabe: Array von Commit-Einträgen mit Hash, Autor, Datum und Nachricht

9. git_create_branch

   • Erstellt einen neuen Zweig

   • Eingänge:

     • repo_path (Zeichenfolge): Pfad zum Git-Repository

     • branch_name (Zeichenfolge): Name des neuen Zweigs

     • start_point (Zeichenfolge, optional): Startpunkt für den neuen Zweig

   • Retouren: Bestätigung der Filialerstellung

10. git_checkout

• Wechselt Zweige

• Eingänge:

  • repo_path (Zeichenfolge): Pfad zum Git-Repository

  • branch_name (Zeichenfolge): Name der auszucheckenden Filiale

• Retouren: Bestätigung Filialwechsel

11. git_show

• Zeigt den Inhalt eines Commits

• Eingänge:

  • repo_path (Zeichenfolge): Pfad zum Git-Repository

  • revision (Zeichenfolge): Die anzuzeigende Revision (Commit-Hash, Branch-Name, Tag).

• Gibt zurück: Inhalt des angegebenen Commits

12. git_init

• Initialisiert ein Git-Repository

• Eingänge:

  • repo_path (Zeichenfolge): Pfad zum Verzeichnis zum Initialisieren des Git-Repos

• Rückgabe: Bestätigung der Repository-Initialisierung

Installation

Verwendung von UV (empfohlen)

Bei der Verwendung uv ist keine spezielle Installation erforderlich. Wir verwenden uvx , um mcp-server-git direkt auszuführen.

Verwenden von PIP

Alternativ können Sie mcp-server-git über pip installieren:

Nach der Installation können Sie es als Skript ausführen mit:

Konfiguration

Verwendung mit Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

• Hinweis: Ersetzen Sie „/Benutzer/Benutzername“ durch den Pfad, auf den dieses Tool zugreifen soll.

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 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.

Für die Docker-Installation:

Verwendung mit Zed

Fügen Sie zu Ihrer Zed-Einstellungendatei (settings.json) hinzu:

Debuggen

Sie können den MCP-Inspektor zum Debuggen des Servers verwenden. Für uvx-Installationen:

Oder wenn Sie das Paket in einem bestimmten Verzeichnis installiert haben oder darauf aufbauen:

Durch Ausführen tail -n 20 -f ~/Library/Logs/Claude/mcp*.log werden die Protokolle vom Server angezeigt und können Ihnen möglicherweise beim Debuggen von Problemen helfen.

Entwicklung

Wenn Sie eine lokale Entwicklung durchführen, gibt es zwei Möglichkeiten, Ihre Änderungen zu testen:

1. Führen Sie den MCP-Inspektor aus, um Ihre Änderungen zu testen. Anweisungen zur Ausführung finden Sie unter Debuggen .

2. Testen Sie mit der Claude-Desktop-App. Fügen Sie Ihrer claude_desktop_config.json Folgendes hinzu:

Docker

UVX

Bauen

Docker-Build:

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.