Open Source · npm · MCP Server

PindeX

Structural Codebase Indexing für KI-Assistenten

MCP-Server für strukturelle Codebase-Indizierung — parst mit tree-sitter, speichert Symbole, Abhängigkeiten und Dokumentation lokal in SQLite, und liefert KI-Assistenten exakt das, was sie brauchen. Ohne ganze Dateien zu laden.

GitHub npm Buy me a coffee

$npminstall-g pindex

MCP Tools: 14; Code & Docs out of the box
Sprachen: 12; tree-sitter + regex
lokale Datenbank: SQLite; kein Cloud-Zwang
Dateien: ≥ 40; ab wann es sich lohnt

Problem

KI-Assistenten lesen zu viel

Ohne Indexer laden Tools wie Claude Code bei jeder Anfrage ganze Dateien in den Kontext — auch wenn nur eine einzige Funktion relevant ist. Das kostet Token, Zeit und Geld.

PindeX löst das, indem es deine Codebase mit tree-sitter und regex-basierten Extraktoren parst, alle Symbole, Importe, Abhängigkeiten und Dokumentation in einer lokalen SQLite-Datenbank indexiert — und 14\n gezielte Tools bereitstellt, damit KI-Assistenten Fragen zum Code beantworten können, ohne ganze Dateien zu laden.

Wann lohnt es sich? PindeX rechnet sich ab ca. ≥ 40 Dateien und ≥ 150 Zeilen/Datei — darunter überwiegt der Tool-Definition-Overhead. Das eingebaute get_project_overview gibt automatisch eine Empfehlung zurück.

TypeScriptJavaScriptPythonJavaKotlinGoRustC#PHPRubyVueSvelte

pindex · setup

$ pindex

╔══════════════════════════════╗

║ PindeX – Ready ║

╚══════════════════════════════╝

Project/my/project

Index~/.pindex/projects/a3f8.../index.db

Port7856

Config.mcp.json (written)

CLAUDE.mdsection added

Hookscreated

Restart Claude Code → pindex-server startet automatisch

Features

14 MCP Tools — eine Frage, eine Antwort

Jedes Tool liefert exakt die Information, die der Assistent für den nächsten Schritt braucht — nicht mehr, nicht weniger.

Code Analysis

search_symbols

Volltext-Suche über alle indizierten Symbole mit SQLite FTS5.

get_symbol

Detailinfos zu einer Funktion oder Klasse — ohne die Datei zu laden.

get_context

Liest einen präzisen Code-Ausschnitt um eine Zeilennummer herum.

get_file_summary

High-Level-Überblick über eine Datei: Symbole, Importe, Exports.

find_usages

Findet alle Referenzen auf ein Symbol im gesamten Projekt.

get_dependencies

Visualisiert den Import-Graphen — wer importiert wen.

get_project_overview

Projektweite Statistiken, Entry Points und Modul-Übersicht.

get_token_stats

Misst Token-Ersparnis in der aktuellen Session.

reindex

Baut den Index für eine Datei oder das gesamte Projekt neu auf.

start_comparison

A/B-Test: indiziert vs. Baseline — für reproduzierbare Messungen.

get_session_memory

Passiv aufgezeichnete Session-Beobachtungen — Symbole, Patterns und Anti-Patterns, automatisch erfasst.

Docs & Context

search_docs

Volltext-Suche über Markdown, YAML, TXT und gespeicherten Kontext.

get_doc_chunk

Lädt spezifische Dokumentations-Abschnitte nach Überschrift.

save_context

Persistiert wichtige Entscheidungen und Fakten session-übergreifend.

Setup

In drei Schritten einsatzbereit

$npm install -g pindex

PindeX global installieren

$cd /mein/projekt && pindex

.mcp.json, CLAUDE.md & Hooks anlegen

$# Claude Code neu starten → Index wird automatisch gebaut

.mcp.json (automatisch via pindex)

{
  "mcpServers": {
    "pindex": {
      "command": "npx",
      "args": ["pindex", "serve"],
      "env": { "PROJECT_ROOT": "/dein/projekt" }
    }
  }
}

Dashboard

pindex-gui — alles im Blick

Das mitgelieferte Web-Dashboard aggregiert Token-Ersparnis, Session-Verlauf und Projektstatistiken über alle registrierten Projekte hinweg. Läuft lokal — keine Cloud, kein Account.

Echtzeit-Chart: Token used vs. estimated without index
Per-Tool-Breakdown: welche Tools wie viel sparen
Session-Vergleich: A/B indexed vs. baseline
Funktioniert auch ohne laufenden pindex-server

PindeX· localhost:7842

◈

Projekte

⌥

Symbole

↻

Sessions

Token Savings per Project

project-a

72%

project-b

58%

project-c

81%

$ pindex-gui · öffnet http://localhost:7842

Multi-Projekt

Mehrere Projekte, eine Suche

Jedes Projekt bekommt eine eigene SQLite-Datenbank unter ~/.pindex/projects/{hash}/index.db.

Mit Federation lassen sich Projekte verknüpfen, sodass Abfragen mehrere Codebasen gleichzeitig durchsuchen — ideal für Monorepos oder voneinander abhängige Repositories.

$ pindex status

[idle]project-a+ 1 federated repo

port: 7856 · index: ~/.pindex/projects/…/

[idle]project-b

port: 7901 · index: ~/.pindex/projects/…/

[idle]project-c

port: 7912 · index: ~/.pindex/projects/…/

Jedes Projekt bekommt eine eigene Datenbank & einen eigenen Port

PindeX ist kostenlos und Open Source

Wenn PindeX dir Token und Zeit spart, freue ich mich über einen Kaffee — das hilft, das Projekt weiterzuentwickeln und neue Features zu bauen.

Buy me a coffee