Provides comprehensive Git operations including repository initialization, cloning, file staging, committing, branch management, tag operations, remote repository handling, and stash management, enabling LLMs to interact with Git repositories.
Supports interactions with GitHub repositories through Git operations like cloning from GitHub URLs, pushing to and pulling from GitHub remotes, enabling LLMs to manage code on GitHub.
Ein MCP-Server (Model Context Protocol), der Tools für die Interaktion mit Git-Repositories bereitstellt. Ermöglicht LLMs und KI-Agenten die Durchführung von Git-Operationen wie Klonen, Commit, Push, Pull, Branch, Diff, Log, Status und mehr über den MCP-Standard.
Dieser Server basiert auf der cyanheads/mcp-ts-template und folgt einer modularen Architektur:
Hinweis für Entwickler : Dieses Repository enthält eine .clinerules- Datei, die als Spickzettel für Entwickler für Ihren LLM-Codierungsagenten mit einer Kurzreferenz für die Codebasismuster, Dateispeicherorte und Codeausschnitte dient.
| Übersicht | Funktionen | Installation |
| Konfiguration | Projektstruktur |
| Tools | Ressourcen | Entwicklung | Lizenz |
Stärken Sie Ihre KI-Agenten und Entwicklungstools mit nahtloser Git-Integration!
Der Git-MCP-Server fungiert als Brücke und ermöglicht Anwendungen (MCP-Clients), die das Model Context Protocol (MCP) verstehen – wie erweiterte KI-Assistenten (LLMs), IDE-Erweiterungen oder benutzerdefinierte Skripte –, direkt und sicher mit lokalen Git-Repositorys zu interagieren.
Anstelle komplexer Skripts oder manueller CLI können Ihre Tools diesen Server für Folgendes nutzen:
Dieser Server basiert auf dem robusten mcp-ts-template und bietet eine standardisierte, sichere und effiziente Möglichkeit, Git-Funktionen über den MCP-Standard bereitzustellen. Dies wird durch die sichere Ausführung des auf dem System installierten Standard- git Kommandozeilentools mithilfe des child_process Moduls von Node.js erreicht. Dies gewährleistet Kompatibilität und nutzt die volle Leistungsfähigkeit von Git.
Nutzt die robusten Dienstprogramme der mcp-ts-template :
McpError ) und automatische Protokollierung.dotenv ).zod zur Schemavalidierung und benutzerdefinierten Bereinigungslogik (entscheidend für Pfade).git -Befehlszeilentools über Node.js child_process und gewährleistet so vollständige Kompatibilität und Zugriff auf die Funktionen von Git.git clean und git reset --hard .GIT_SIGN_COMMITS und die serverseitige Git-Konfiguration. Enthält einen optionalen Tool-Parameter, um bei fehlgeschlagener Signierung auf nicht signierte Commits zurückzugreifen.dist/ in JavaScript kompiliert und der Einstiegspunkt ausführbar gemacht.Konfigurieren Sie den Server mithilfe von Umgebungsvariablen. Erstellen Sie eine .env Datei im Projektstamm (Kopie aus .env.example ) oder legen Sie sie in Ihrer Umgebung fest.
| Variable | Beschreibung | Standard |
|---|---|---|
MCP_TRANSPORT_TYPE | Transportmechanismus: stdio oder http . | stdio |
MCP_HTTP_PORT | Port für den HTTP-Server (wenn MCP_TRANSPORT_TYPE=http ). Bei Belegung werden die nächsten Ports erneut versucht. | 3010 |
MCP_HTTP_HOST | Hostadresse für den HTTP-Server (wenn MCP_TRANSPORT_TYPE=http ). | 127.0.0.1 |
MCP_ALLOWED_ORIGINS | Durch Kommas getrennte Liste zulässiger Ursprünge für CORS (wenn MCP_TRANSPORT_TYPE=http ). | (keiner) |
MCP_LOG_LEVEL | Protokollierungsebene ( debug , info , notice , warning , error , crit , alert , emerg ). Von der Vorlage geerbt. | info |
GIT_SIGN_COMMITS | Auf "true" setzen, um Signierversuche für Commits zu ermöglichen, die vom Tool git_commit durchgeführt werden. Erfordert serverseitiges Git/Key-Setup (siehe unten). | false |
MCP_AUTH_SECRET_KEY | Geheimer Schlüssel zum Signieren/Verifizieren von Authentifizierungstoken (erforderlich, wenn die Authentifizierung in Zukunft aktiviert wird). | '' |
Fügen Sie zu Ihren MCP-Clienteinstellungen hinzu (z. B. cline_mcp_settings.json ):
Die Codebasis folgt einer modularen Struktur innerhalb des src/ -Verzeichnisses:
Für einen detaillierten Dateibaum führen Sie npm run tree aus oder sehen Sie sich docs/tree.md an.
Der Git MCP-Server bietet eine Reihe von Tools für die Interaktion mit Git-Repositorys, die über das Model Context Protocol aufgerufen werden können.
| Werkzeugname | Beschreibung | Hauptargumente |
|---|---|---|
git_add | Stellt bestimmte Dateien oder Muster bereit. | path? files? |
git_branch | Verwaltet Zweige (auflisten, erstellen, löschen, umbenennen, aktuelle anzeigen). | path? mode , branchName? newBranchName? startPoint? force? all? remote? |
git_checkout | Wechselt Zweige oder stellt Arbeitsbaumdateien wieder her. | path? branchOrPath , newBranch? force? |
git_cherry_pick | Wendet durch vorhandene Commits eingeführte Änderungen an. | path? commitRef , mainline? strategy? noCommit? signoff? |
git_clean | Entfernt nicht verfolgte Dateien. Erfordert force: true . | path? force , dryRun? directories? ignored? |
git_clear_working_dir | Löscht das sitzungsspezifische Arbeitsverzeichnis. | (keiner) |
git_clone | Klont ein Repository in einen angegebenen absoluten Pfad. | repositoryUrl , targetPath , branch? depth? quiet? |
git_commit | Übernimmt stufenweise Änderungen. Unterstützt Autorüberschreibung und Signaturkontrolle. | path? ?, message , author? allowEmpty? amend? forceUnsignedOnFailure? |
git_diff | Zeigt Änderungen zwischen Commits, Arbeitsbaum usw. an. | path? , commit1? , commit2? , staged? , file? |
git_fetch | Lädt Objekte und Referenzen aus anderen Repositories herunter. | path? remote? prune? tags? all? |
git_init | Initialisiert ein neues Git-Repository unter dem angegebenen absoluten Pfad. | path , initialBranch? bare? quiet? |
git_log | Zeigt Commit-Protokolle an. | path? , maxCount? , author? , since? , until? , branchOrFile? |
git_merge | Führt den angegebenen Zweig mit dem aktuellen Zweig zusammen. | path? branch , commitMessage? noFf? squash? abort? |
git_pull | Ruft Daten aus einem anderen Repository oder lokalen Zweig ab und integriert diese. | path? remote? branch? rebase? ffOnly? |
git_push | Aktualisiert Remote-Refs mithilfe lokaler Refs. | path? remote? branch? remoteBranch? force? forceWithLease? setUpstream? tags? delete? |
git_rebase | Wendet Commits erneut auf einem anderen Basistipp an. | path? mode? upstream? branch? interactive? strategy? strategyOption? onto? |
git_remote | Verwaltet Remote-Repositorys (auflisten, hinzufügen, entfernen, anzeigen). | path? mode , name? url? |
git_reset | Setzt den aktuellen HEAD auf einen angegebenen Zustand zurück. Unterstützt Soft-, Mixed- und Hard-Modi. Verwenden Sie „hard“ mit Vorsicht . | path? ?, mode? commit? |
git_set_working_dir | Legt das Standardarbeitsverzeichnis für die aktuelle Sitzung fest. Erfordert einen absoluten Pfad. | path , validateGitRepo? |
git_show | Zeigt Informationen zu Git-Objekten (Commits, Tags usw.) an. | path? ref ., filePath? |
git_stash | Verwaltet gespeicherte Änderungen (Auflisten, Anwenden, Pop, Drop, Speichern). | path? mode , stashRef? message? |
git_status | Ruft den Repository-Status ab (Zweig, bereitgestellte, geänderte, nicht verfolgte Dateien). | path? |
git_tag | Verwaltet Tags (Auflisten, Erstellen mit Anmerkungen/leichtgewichtig, Löschen). | path? mode , tagName? message? commitRef? annotate? |
Hinweis: Der path ist für die meisten Tools standardmäßig das Arbeitsverzeichnis der Sitzung, wenn er über git_set_working_dir festgelegt wird.
MCP-Ressourcen sind in dieser Version (v2.0.8) nicht implementiert.
Diese Version konzentriert sich auf die überarbeitete Implementierung der Git-Tools basierend auf der neuesten mcp-ts-template und dem MCP SDK v1.11.0. Zuvor verfügbare Ressourcenfunktionen wurden im Rahmen dieses umfangreichen Updates vorübergehend entfernt.
Wenn Sie Zugriff auf MCP-Ressourcen benötigen (z. B. zum Lesen von Dateiinhalten direkt über den Server), verwenden Sie bitte die stabile Version v1.2.4 .
Zukünftige Entwicklungen können die Ressourcenfunktionen in einer nachfolgenden Version wieder einführen.
Hinweis: Diese Version (v2.0.0) konzentriert sich auf die Refaktorierung und Aktualisierung der wichtigsten Git-Tools basierend auf dem neuesten MCP SDK. MCP-Ressourcenfunktionen sind in dieser Version nicht implementiert. Für den Ressourcenzugriff verwenden Sie bitte v1.2.4 .
Dieses Projekt ist unter der Apache-Lizenz 2.0 lizenziert – Einzelheiten finden Sie in der Datei LICENSE .
You must be authenticated.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Ein Model Context Protocol-Server, der großen Sprachmodellen die Interaktion mit Git-Repositorys über eine robuste API ermöglicht und Vorgänge wie Repository-Initialisierung, Klonen, Datei-Staging, Commiting und Branch-Verwaltung unterstützt.