git-graph-mcp

Ein lokal-first Terminaltool für Git-Commit-Graphen, das zugleich einen standardmäßigen MCP-stdio-Dienst bereitstellt. Es ermöglicht die Auswahl von Commits oder Bereichen im Terminal, sodass MCP-Clients wie Claude Code, Codex oder Cursor denselben budgetbegrenzten Git-Kontext lesen können.

Was es kann

• Commit-Graph, Branches, Commit-Details und Arbeitsbereichsstatus im Terminal anzeigen;

• Commit-, Range- und Ref-Auswahlen speichern und zwischen CLI/TUI/MCP wiederverwenden;

• graph, status, context, search, diff, history und resources über MCP lesen;

• Sichere Vorschauen für Branch-Aktionen und reset erzeugen, ohne reset/checkout/push automatisch auszuführen;

• Mit doctor Node.js, Git, Repository, MCP-Konfiguration und stdio-Handshake prüfen.

Related MCP server: org-as-code MCP Server

Schnellstart

Voraussetzungen: Git muss sich im PATH befinden; offiziell unterstützt wird Node.js 22+.

npm ci
node .\bin\git-graph-mcp.js graph --plain --limit 8
node .\bin\git-graph-mcp.js doctor

Interaktive TUI:

node .\bin\git-graph-mcp.js graph

Häufige Vorgänge:

node .\bin\git-graph-mcp.js status
node .\bin\git-graph-mcp.js search --limit 20
node .\bin\git-graph-mcp.js select commit <commit-oid>
node .\bin\git-graph-mcp.js selected
node .\bin\git-graph-mcp.js doctor --json

Wenn sich das Ziel-Repositorium nicht im aktullen Verzeichnis befindet, hängen Sie --repo <path> an den Befehl an.

MCP-Konfiguration

Die .mcp.json im Repositorium-Stammverzeichnis verwendet lokales stdio:

{
  "mcpServers": {
    "git-graph": {
      "type": "stdio",
      "command": "node",
      "args": ["./bin/git-graph-mcp.js", "mcp"]
    }
  }
}

Der Server bietet 12 begrenzte Tools und zwei schreibgeschützte resources: git-graph://defaul/selection und git-graph://defaul/status. MCP stdout enthält ausschließlich Protokollnachrichten; Diagnoseinformationen werden nach stderr geschrieben und geben keine Repositorium-Pfade, Konfigurationswerte oder Anforderungsinhalte wieder.

Sicherheitsgrenzen

Der Standard-Workflow ist schreibgeschützt. Das Erstellen von Branches erfordert einen expliziten Aufruf und verschiebt keine vorhandenen Branches; reset erzeugt nur Vorschauen, und git_revalidate_plan validiert vor der Aktion den Zustands-Fingerabdruck des Repositoriums. Das Projekt startet keine Netzwerk-Listener, und lädt keine Repositorium-Inhalte hoch.

Entwicklung und Veröffentlichung

npm run check
npm run test:package-install

Weitere Information:

• Fünf-Minuten-Demo

• Fähigkeiten und Testnachweise

• Mitwirkungsleitfaden

• Sicherheitsrichtlinie

• Release-Checkliste