Skip to main content
Glama
ShinonomeAya

git-graph-mcp

by ShinonomeAya

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.

Terminal-Vorschau

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

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    B
    maintenance
    MCP 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
    -
  • A
    license
    Not graded
    quality
    A
    maintenance
    A 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
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables 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