MCP-Server für TypeScript-Projekte ersetzt Grep-Muster von Claude Code durch indizierte Symbol-Suchen

Ein Entwickler hat einen MCP-Server erstellt, der speziell darauf ausgelegt ist, die Leistung von Claude Code bei TypeScript-Projekten zu verbessern, indem er dessen Grep-and-Guess-Muster durch indizierte Symbolabfragen ersetzt. Das Tool ist kostenlos und Open Source.

Das Problem mit dem aktuellen Agentenverhalten

Bei der Verwendung von Claude Code und Cursor in TypeScript-Projekten zeigt sich ein häufiges Muster: Der Agent durchsucht Dateien, öffnet wahrscheinliche Treffer, liest große Code-Mengen, stellt fest, dass es der falsche Ort ist, und versucht es erneut. Dem Agenten fehlt ein strukturelles Verständnis der Codebasis, und jede Sitzung beginnt von vorn.

Wie der MCP-Server funktioniert

Der Server bietet strukturierten Zugriff auf die Codebasis, indem er einen Live-SQLite-Index des Projekts pflegt, der Folgendes umfasst:

• Symbole
• Aufrufstellen
• Importe
• Klassenhierarchie

Dadurch kann der Agent die Struktur direkt abfragen. Anstatt nach "handleRequest" zu suchen, kann der Agent direkt zur exakten Datei und Zeile für dieses Symbol springen.

Leistungsbenchmarks

Getestet an einem TypeScript-Projekt mit 31 Dateien, bei dem dieselben Aufgaben mit und ohne Index durchgeführt wurden:

• Eine Funktion finden: 1.350 Token mit Grep vs. 500 Token mit Index (63 % weniger)
• Aufrufer über 3 Dateien verfolgen: 2.850 Token mit Grep vs. 900 Token mit Index (68 % weniger)
• Vererbung über 15+ Dateien abbilden: 4.800 Token mit Grep vs. 1.000 Token mit Index (79 % weniger)

Die Grep-Leistung verschlechtert sich mit wachsender Codebasis, während indizierte Abfragen konstant bleiben.

Woher die Einsparungen kommen

Der Entwickler dachte zunächst, dass die Symbolsuche der Hauptvorteil wäre, entdeckte aber drei Schlüsselbereiche, in denen der Index erhebliche Effizienzgewinne bietet:

• get_callers-Abfragen ersetzen das Muster, bei dem Agenten 4-5 Dateien lesen, um herauszufinden, wer eine Funktion aufruft
• Teilweise Lesevorgänge: Die genaue Zeile zu kennen bedeutet, 20 Zeilen statt einer gesamten Datei zu lesen (was über die Hälfte der Einsparungen ausmacht)
• trace_middleware teilt dem Agenten mit, was vor einem Route-Handler ausgeführt wird, und eliminiert die Notwendigkeit, den Router, jede Middleware-Datei zu lesen und die Reihenfolge zu rekonstruieren

Einschränkungen

Das Tool hat Schwierigkeiten mit:

• Dynamischen Mustern (berechnete Methodennamen usw.)
• Dependency-Injection-Konfigurationen
• Alles außerhalb der eigenen Codebasis

Obwohl nicht perfekt, reduziert das Tool die Trial-and-Error-Schleife in der agentengestützten Entwicklung erheblich.