Code-Graph-MCP: Open-Source-MCP-Server reduziert Claude-Code-Token-Verbrauch um 40-60%

code-graph-mcp ist ein Open-Source-MCP-Server, der Codebasen in einen AST-Wissensgraphen indexiert, um die Claude-Code-Token-Nutzung zu reduzieren. Anstatt dass Claude mehrere grep/read/glob-Aufrufe tätigt, um die Codestruktur zu verstehen, fragt er den Graphen nach strukturierten Antworten in einzelnen Aufrufen ab.

Wie es funktioniert

Das Tool parst Code mit Tree-sitter, extrahiert Symbole (Funktionen, Klassen, Typen, Schnittstellen) und ihre Beziehungen (Aufrufe, Importe, Vererbung, Exporte, HTTP-Routenbindungen) und speichert alles in SQLite mit FTS5-Volltextsuche und sqlite-vec für Vektorähnlichkeit. Es unterstützt 10 Sprachen: TypeScript, JavaScript, Go, Python, Rust, Java, C, C++, HTML und CSS.

Wichtige Tools

• project_map — Vollständige Architekturübersicht in einem Aufruf (Module, Abhängigkeiten, Hot-Funktionen, Einstiegspunkte)
• semantic_code_search — Hybride Suche, die BM25 + Vektorähnlichkeit mit RRF-Fusion kombiniert
• get_call_graph — Aufrufer/Aufgerufene mit rekursiven CTEs nachverfolgen
• impact_analysis — Sehen, was alles von einer Funktion abhängt, bevor sie geändert wird
• trace_http_chain — HTTP-Routen vom Handler zum DB-Aufruf nachverfolgen (unterstützt Express, Flask/FastAPI, Go)
• module_overview, dependency_graph, find_similar_code, get_ast_node — Zusätzliche Toolkit-Funktionen

Effizienzergebnisse

Bei einem 33-Dateien-Rust-Projekt:

• Verstehen der Projektarchitektur: Reduziert von 5-8 Tool-Aufrufen auf 1 Aufruf
• Nachverfolgen einer 2-stufigen Aufrufkette: Reduziert von 8-15 Aufrufen auf 1 Aufruf
• Auswirkungsanalyse vor Änderungen: Reduziert von 10-20+ Aufrufen auf 1 Aufruf
• Finden von Funktionen nach Konzept: Reduziert von 3-5 Aufrufen auf 1 Aufruf

Insgesamt: ~80 % weniger Tool-Aufrufe pro Navigationsaufgabe, ~95 % weniger Quellcode im Kontext und 40-60 % Einsparungen bei den gesamten Sitzungstokens.

Technische Details

Inkrementelle Indexierung verwendet BLAKE3-Merkle-Bäume, um Inhalts-Hashes zu verfolgen — nur geänderte Dateien werden neu geparst. Unveränderte Verzeichnisunterbäume werden über mtime-Cache vollständig übersprungen. Wenn sich eine Funktionssignatur ändert, sorgt Dirty-Propagation automatisch für die Neugenerierung des Kontexts für alle nachgelagerten Aufrufer.

Das Tool hat keine externen Abhängigkeiten — es ist eine einzige 19-MB-Binärdatei mit eingebettetem SQLite und gebündeltem sqlite-vec. Kein Docker, Cloud-API oder Datenbankserver erforderlich. Optionale lokale Einbettungen verwenden ein Candle-basiertes Embedding-Modell, feature-gated, sodass man ohne es bauen kann, wenn Vektorsuche nicht benötigt wird.

Installation

Funktioniert mit Claude Code, Cursor, Windsurf oder jedem MCP-Client.

Claude-Code-Plugin (empfohlen):

/plugin marketplace add sdsrss/code-graph-mcp
/plugin install code-graph-mcp

Dies beinhaltet den MCP-Server plus Slash-Befehle (/understand, /trace, /impact), Auto-Indexing-Hooks (re-indexiert bei jeder Dateibearbeitung), StatusLine-Gesundheitsanzeige und automatische Updates.

Für jeden MCP-Client:

npx -y @sdsrs/code-graph

Oder zur MCP-Konfiguration hinzufügen:

{
  "mcpServers": {
    "code-graph": {
      "command": "npx",
      "args": ["-y", "@sdsrs/code-graph"]
    }
  }
}

Wann man es nicht verwenden sollte

grep ist immer noch besser für die exakte Suche nach Zeichenketten/Konstanten. Wenn man jedes Vorkommen von TODO oder eines bestimmten Fehlercodes finden muss, sollte man grep verwenden. code-graph-mcp glänzt, wenn man Struktur, Beziehungen und Code-Architektur verstehen muss.