- Live
- Open Source
- npm
- MCP-Server
- MIT
PindeX
Strukturelle Codebase-Indizierung für KI-Assistenten
Ohne Index lesen Tools wie Claude Code bei vielen Fragen ganze Dateien in den Kontext, auch wenn nur eine Funktion zählt. PindeX parst dein Projekt mit tree-sitter und regex-basierten Extraktoren, speichert Symbole, Importe, Aufrufe und Dokumentation in einer lokalen SQLite-Datenbank und stellt deinem Assistenten gezielte MCP-Tools bereit: Symbole suchen, Aufrufer finden, Call-Pfade zwischen zwei Funktionen ermitteln, Doku-Abschnitte laden. Im eigenen Realism-Benchmark (Q&A-Aufgaben, N=1) hat das rund 18–19 % Token gespart – am meisten bei Fragen, die über viele Dateien und Abhängigkeiten gehen.
Live unter npmjs.com/package/pindex
- MCP-Tools
- 16
- Sprachen
- 12
- Datenhaltung
- lokal in SQLite
- Lizenz
- MIT, kostenlos
Funktionen
Code verstehen
- Symbolsuche
- search_symbols durchsucht alle indizierten Funktionen, Klassen und Konstanten per SQLite-Volltextsuche (FTS5).
- Kontext statt ganzer Datei
- get_symbol, get_context und get_file_summary liefern Signatur, Ausschnitt oder Datei-Überblick, ohne die Datei komplett zu laden.
- Aufrufgraph
- find_usages und get_call_path arbeiten auf einem aufgelösten Call-Graphen und markieren jede Kante als sicher erkannt oder abgeleitet.
- Projektüberblick
- get_project_overview zeigt Verzeichnisgruppen, zentrale Symbole und Datei-Cluster – und sagt dir, ob sich der Index für dein Projekt lohnt.
Doku & Gedächtnis
- Doku-Suche
- Markdown-, YAML- und Textdateien werden in Abschnitte zerlegt und sind über search_docs und get_doc_chunk abrufbar.
- Kontext über Sessions hinweg
- Mit save_context hält dein Assistent wichtige Entscheidungen fest und findet sie in der nächsten Session wieder.
- Session-Memory
- get_session_memory liefert passiv mitgeschriebene Beobachtungen zu geänderten Symbolen und Mustern.
Setup & Betrieb
- Ein Befehl pro Projekt
- pindex legt .mcp.json, den CLAUDE.md-Abschnitt und die Claude-Code-Hooks an und führt bestehende Einträge zusammen, statt sie zu überschreiben.
- Claude-Code-Plugin
- Alternativ installierst du PindeX als Plugin; der Server konfiguriert sich dann in jedem Projekt selbst.
- Federation
- Verknüpfte Repositories lassen sich gemeinsam durchsuchen – praktisch bei Monorepos oder voneinander abhängigen Projekten.
- Lokales Dashboard
- pindex-gui zeigt Token-Ersparnis, Sessions und A/B-Vergleiche über alle Projekte – auch ohne laufenden Server.
So funktioniert es
Installieren
npm install -g pindex – oder als Claude-Code-Plugin über den Marketplace phash/PindeX.
Projekt einrichten
Im Projektordner pindex ausführen: Root wird erkannt, .mcp.json, CLAUDE.md-Abschnitt und Hooks werden angelegt.
Claude Code neu starten
Der Server startet automatisch, baut den Index und hält ihn bei Dateiänderungen aktuell.
Gezielt fragen
Dein Assistent nutzt die MCP-Tools statt ganzer Dateien; die Ersparnis siehst du im Dashboard.
Läuft komplett lokal
- Index, Projekt-Registry, Session-Memory und Token-Statistiken liegen ausschließlich auf deinem Rechner (SQLite unter <projekt>/.pindex/ bzw. ~/.pindex/).
- Keine Telemetrie, keine Analytics, kein Nach-Hause-Telefonieren.
- LLM-Zusammenfassungen sind standardmäßig aus; nur wenn du sie aktivierst, gehen Code-Ausschnitte an den Anbieter, den du selbst konfigurierst – mit deinem eigenen API-Key.
- Das Dashboard bindet standardmäßig nur an 127.0.0.1; dein Browser lädt dort lediglich Chart.js und dayjs vom jsDelivr-CDN.
- Eine mitgelieferte .mcp.json aus einem fremden Repo kann keine Einstellungen wie PINDEX_LSP oder API-Keys in deine Konfiguration schmuggeln.
Technik
- TypeScript
- Node.js ≥ 18
- Model Context Protocol SDK
- tree-sitter
- SQLite (better-sqlite3, FTS5)
- chokidar
- Express + WebSocket
- Chart.js
- Zod
- Vitest
Häufige Fragen
Ab wann lohnt sich PindeX?
Als Faustregel ab etwa 40 Dateien mit im Schnitt 150 Zeilen. Darunter überwiegt der Overhead der Tool-Definitionen. get_project_overview gibt dir dazu eine Empfehlung für dein Projekt.
Wie viel spart es wirklich?
Im eigenen Realism-Benchmark (Sonnet 4.6, N=1, je 6 Q&A-Aufgaben) waren es auf zwei TypeScript-Codebasen 18 bzw. 19 % weniger Token. Am meisten bringt es bei Fragen über Abhängigkeiten und mehrere Dateien, bei einfachen Symbol-Lookups ist es etwa ausgeglichen.
Welche Sprachen werden unterstützt?
TypeScript, JavaScript, Python, Java, Kotlin, Go, Rust, C#, PHP, Ruby, Vue und Svelte. TypeScript/JavaScript laufen über tree-sitter, die übrigen über regex-basierte Extraktoren; für Python kannst du optional Pyright zuschalten.
Mit welchen Clients funktioniert es?
Mit Claude Code (auch als Plugin), mit Goose und grundsätzlich mit jedem MCP-Client, der Server über stdio anbindet.
Was kostet PindeX?
Nichts. PindeX ist Open Source unter MIT-Lizenz. Wenn es dir hilft, freue ich mich über einen Kaffee.
Aus den News
PindeX: Ein MCP-Server, der Claude Code gezielt mit Code versorgt
Wer mit Claude Code an großen Codebases arbeitet, stößt schnell an Kontextgrenzen. PindeX indiziert das Repository mit tree-sitter und liefert dem Assistenten nur die Symbole, die er wirklich braucht.
Verwandte Projekte
PindeX ansehen
PindeX auf npmnpmjs.com/package/pindex
Du brauchst etwas Ähnliches für dich, deine Praxis oder deinen Verein? Erzähl mir davon.