srclight: Vollständig lokaler Code-Indexierungs-MCP-Server mit Ollama-Embeddings

Was srclight leistet

srclight ist ein MCP-Server (Model Context Protocol), der tiefgehende Code-Indizierung mit semantischer Suchfunktion bietet, die vollständig auf Ihrem lokalen Rechner läuft. Ihr Code verlässt nie Ihr System, und es werden keine API-Schlüssel oder Cloud-Aufrufe benötigt.

Technischer Stack

• Parsing: tree-sitter AST-Parsing für 11 Sprachen: Python, C, C++, C#, JavaScript, TypeScript, Dart, Swift, Kotlin, Java, Go
• Schlüsselwortsuche: SQLite FTS5 mit 3 Indizes: Symbolnamen mit CamelCase/Snake_Case-Trennung, Trigramm für Teilstring-Abgleich, Porter-Stemmer für Docstrings
• Embeddings: Ollama für lokale Embeddings (qwen3-embedding standardmäßig, nomic-embed-text funktioniert ebenfalls)
• Vektorsuche: cupy für GPU-beschleunigte Kosinus-Ähnlichkeit (~3ms bei 27K Vektoren auf RTX 3090) mit numpy-Fallback (~105ms) falls keine GPU verfügbar ist
• Hybridsuche: Reciprocal Rank Fusion (RRF, k=60) kombiniert FTS5-Schlüsselwort-Ergebnisse mit embedding-basierten semantischen Ergebnissen

Embedding-Implementierung

Das Embedding-System verwendet .npy-Sidecar-Dateien, die einmal in den GPU-VRAM geladen werden und dann alle Abfragen aus dem VRAM bedienen. Der Kaltstart dauert ~300ms, nachfolgende Abfragen jeweils ~3ms. Das System ist inkrementell – es embeddet nur Symbole neu, deren Inhalts-Hash sich geändert hat. Ein vollständiges Embedding von 45K Symbolen dauert ~15 Minuten mit qwen3-embedding, während inkrementelle Updates sofort erfolgen.

Verfügbare Tools

srclight bietet insgesamt 25 MCP-Tools:

• Symbolsuche (FTS5 + semantisch + hybrid RRF)
• Beziehungsgraph (Aufrufer, Aufgerufene, transitive Abhängigkeiten, Implementierer, Vererbungsbaum, Testabdeckung)
• Git-Änderungsintelligenz (Blame pro Symbol, Hotspot-Erkennung, unbestätigte WIPs, Commit-Historie)
• Build-System-Awareness (CMake, .csproj-Ziele und Plattformbedingungen)
• Multi-Repo-Arbeitsbereiche mit SQLite ATTACH+UNION über Repos hinweg, ermöglicht Suche über 10+ Repos gleichzeitig

Bereitstellung und Leistung

Der Autor indiziert 13 Repos (45K Symbole) in einem Arbeitsbereich. Alles wird in einer einzelnen SQLite-Datei pro Repo gespeichert – kein Docker, Redis, Vektordatenbank oder Cloud-Embedding-APIs erforderlich. Git-Hooks (post-commit, post-checkout) halten den Index automatisch aktuell.

Laut der Umfrage des Autors unter 50+ MCP-Code-Suchservern in den wichtigsten Registrierungen sind die meisten grep-Wrapper oder benötigen Cloud-Embedding-APIs (OpenAI, Voyage). srclight wird als der einzige beschrieben, der lokale FTS5-Schlüsselwortsuche + lokale Ollama-Embeddings + GPU-beschleunigten Vektor-Cache + Git-Intelligenz + Multi-Repo-Arbeitsbereiche in einer einzigen pip-Installation kombiniert.

Kompatibilität und Installation

Funktioniert mit jedem MCP-Client inklusive Claude Code, Cursor, Windsurf, Cline und VS Code. Installation erfolgt über pip install srclight. Das Projekt ist MIT-lizenziert und vollständig Open Source unter https://github.com/srclight/srclight.