SourceRecall

SourceRecall ist ein selbst gehosteter Repository-Intelligence-Dienst für KI-gestützte Entwicklungsassistenten. Es indexiert saubere Git-Arbeitsbäume in Qdrant, kombiniert semantische und lexikalische Abfragen, bewertet Kandidaten über einen separaten Jetson-NLP-Dienst neu und stellt die Ergebnisse über HTTP und das Model Context Protocol (MCP) bereit.

Es ist für den Einsatz in einem kleinen vertrauenswürdigen Netzwerk gedacht, in dem Repository-Daten unter der Kontrolle des Betreibers bleiben müssen.

Highlights

• Sichere Repository-Eingrenzung unter einem verwalteten Root-Verzeichnis

• Indizierung von sauberen Commits mit Datei-, Chunk-, Modell- und Schema-Herkunft

• Autoritative Voll-Neuindizierung, die veraltete Qdrant-Punkte entfernt

• Hybride Vektor- und ripgrep-Abfrage mit chunk-bewusster Reciprocal Rank Fusion

• Optionale Cross-Encoder-Neubewertung durch Jetson NLP

• Schlankes Streamable-HTTP-MCP-Integration mit strukturierten Tool-Antworten

• Dauerhafter SQLite-Job- und Index-Status

• Validierte YAML-Konfiguration und strukturierte rotierende Logdateien

• Single-Worker, serialisiertes Indizierungsmodell mit expliziten Ressourcengrenzen

Related MCP server: Qurio MCP Server

Architektur

Continue Agent
    |
    | Streamable HTTP MCP
    v
SourceRecall MCP :8071
    |
    v
SourceRecall API :8070
    |                 |
    |                 +--> managed Git repositories
    |                      + ripgrep lexical retrieval
    |
    +--> Qdrant :6333
    +--> Jetson NLP :8091 (/v1/embeddings and /v1/rerank)

SourceRecall verwaltet Repository-, Pfad-, Commit-, Chunk- und Abfragesemantik. Jetson NLP bleibt ein zustandsloser Inferenzdienst, der nur Text, Vektoren und Bewertungen kennt.

Repository-Struktur

config/             Versioned configuration template
deploy/systemd/     API and MCP systemd units
diags/              Deployment validation utilities
docs/               Architecture, API, deployment, and operations guides
src/source_recall/  Installable Python package
tests/              Automated tests

API auf einen Blick

curl http://source-recall:8070/live

curl -X POST http://source-recall:8070/index \
  -H 'Content-Type: application/json' \
  -d '{"repository":"episode-tracker"}'

curl -X POST http://source-recall:8070/search \
  -H 'Content-Type: application/json' \
  -d '{
    "repository":"episode-tracker",
    "query":"where are TV episode credits normalized?",
    "limit":8
  }'

Wenn security.api_token konfiguriert ist, füge allen API-Anfragen außer Health-Checks den Header Authorization: Bearer <token> hinzu.

Produktionspfade

Die vollständige Installationsanleitung findest du unter Deployment.

Dokumentation

• Architektur

• API-Referenz

• Konfiguration

• Deployment

• Entwicklung

• MCP-Integration

• Betrieb

• Erst-Audit

Aktueller Umfang

Die erste Version führt eine autoritative Vollindizierung durch. Inkrementelle Git-Indizierung, Webhook-Aufnahme, syntaxbewusstes Chunking, Symbolgraphen und Referenzanalyse sind geplante Erweiterungen und keine behaupteten Funktionen. Indizierungsaufträge sind für die Statusberichterstattung dauerhaft, werden aber in einem lokalen Prozess ausgeführt; dies ist keine verteilte Job-Warteschlange.

Die Dienste terminieren kein TLS, und der MCP-Endpunkt implementiert keine Client-Authentifizierung. Betreibe sie in einem vertrauenswürdigen privaten Netzwerk oder hinter einem authentifizierten Reverse-Proxy. Siehe Sicherheit.

Lizenz

SourceRecall ist verfügbar unter der MIT License.