Git-MCP-Server

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

git_status
- Zeigt den Status des Arbeitsbaums an
- Eingang:
  - repo_path (Zeichenfolge): Pfad zum Git-Repository
- Rückgabe: Aktueller Status des Arbeitsverzeichnisses als Textausgabe
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
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
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
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
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
git_reset
- Hebt die Bereitstellung aller bereitgestellten Änderungen auf
- Eingang:
  - repo_path (Zeichenfolge): Pfad zum Git-Repository
- Rückgabe: Bestätigung des Rücksetzvorgangs
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
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
git_checkout

Wechselt Zweige
Eingänge:
- repo_path (Zeichenfolge): Pfad zum Git-Repository
- branch_name (Zeichenfolge): Name der auszucheckenden Filiale
Retouren: Bestätigung Filialwechsel

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

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:

pip install mcp-server-git

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

python -m mcp_server_git

Konfiguration

Verwendung mit Claude Desktop

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

"mcpServers": {
  "git": {
    "command": "uvx",
    "args": ["mcp-server-git", "--repository", "path/to/git/repo"]
  }
}

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

"mcpServers": {
  "git": {
    "command": "docker",
    "args": ["run", "--rm", "-i", "--mount", "type=bind,src=/Users/username,dst=/Users/username", "mcp/git"]
  }
}

"mcpServers": {
  "git": {
    "command": "python",
    "args": ["-m", "mcp_server_git", "--repository", "path/to/git/repo"]
  }
}

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.

{
  "mcp": {
    "servers": {
      "git": {
        "command": "uvx",
        "args": ["mcp-server-git"]
      }
    }
  }
}

Für die Docker-Installation:

{
  "mcp": {
    "servers": {
      "git": {
        "command": "docker",
        "args": [
          "run",
          "--rm",
          "-i",
          "--mount", "type=bind,src=${workspaceFolder},dst=/workspace",
          "mcp/git"
        ]
      }
    }
  }
}

Verwendung mit Zed

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

"context_servers": [
  "mcp-server-git": {
    "command": {
      "path": "uvx",
      "args": ["mcp-server-git"]
    }
  }
],

"context_servers": {
  "mcp-server-git": {
    "command": {
      "path": "python",
      "args": ["-m", "mcp_server_git"]
    }
  }
},

Debuggen

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

npx @modelcontextprotocol/inspector uvx mcp-server-git

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

cd path/to/servers/src/git
npx @modelcontextprotocol/inspector uv run mcp-server-git

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:

Führen Sie den MCP-Inspektor aus, um Ihre Änderungen zu testen. Anweisungen zur Ausführung finden Sie unter Debuggen .
Testen Sie mit der Claude-Desktop-App. Fügen Sie Ihrer claude_desktop_config.json Folgendes hinzu:

Docker

{
  "mcpServers": {
    "git": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--mount", "type=bind,src=/Users/username/Desktop,dst=/projects/Desktop",
        "--mount", "type=bind,src=/path/to/other/allowed/dir,dst=/projects/other/allowed/dir,ro",
        "--mount", "type=bind,src=/path/to/file.txt,dst=/projects/path/to/file.txt",
        "mcp/git"
      ]
    }
  }
}

UVX

{
"mcpServers": {
  "git": {
    "command": "uv",
    "args": [ 
      "--directory",
      "/<path to mcp-servers>/mcp-servers/src/git",
      "run",
      "mcp-server-git"
    ]
  }
}

Bauen

Docker-Build:

cd src/git
docker build -t mcp/git .

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.

git MCP server

Integrations

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

Überblick

Werkzeuge

Installation

Verwendung von UV (empfohlen)

Verwenden von PIP

Konfiguration

Verwendung mit Claude Desktop

Verwendung mit VS Code

Verwendung mit Zed

Debuggen

Entwicklung

Docker

UVX

Bauen

Lizenz

Tools

Related MCP Servers

Git MCP Server

Github MCP Server

GitHub MCP Server

Git Prompts MCP Server

Appeared in Searches

New MCP Servers