git-graph-mcp
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
doctorNode.js, Git, Repository, MCP-Konfiguration und stdio-Handshake prüfen.
Related MCP server: worktree-map
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 doctorInteraktive TUI:
node .\bin\git-graph-mcp.js graphHä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 --jsonWenn 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-installWeitere Information:
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server for siGit (sigit.si): browse repos, search code, manage PRs/issues, web search.
Render, verify, describe, and safely edit Mermaid diagrams through MCP.
Plain-English git via MCP: 22 tools to branch, commit, push, and tag. No git jargon.
A MCP server built for developers enabling Git based project management with project and personal…
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides batch file operations, search, and essential git workflows via stdio MCP.22 npm1Apache 2.0
- FlicenseNot gradedqualityBmaintenanceMCP server that visualizes git branch genealogy and worktree locations within a repository, marking the current session position. Supports creating branches/worktrees, safe deletion/cleanup, and session navigation with fallback guidance.2-
- AlicenseNot gradedqualityAmaintenanceA local git MCP server. It exposes 12 git operations to an MCP client over stdio, allowing the client to inspect and work with a git repository on your machine, including status, diffs, log, branches, staging, and commits.MIT
- AlicenseNot gradedqualityCmaintenanceEnables people and AI agents to query local code repositories as graphs through stdio MCP tools for project listing, search, dependency tracing, impact analysis, bridge detection, node inspection, bounded code reading, and optional LSP definition/reference lookups.MIT