SourceRecall

SourceRecall es un servicio de inteligencia de repositorios autoalojado para asistentes de codificación de IA. Indexa árboles de trabajo limpios de Git en Qdrant, combina recuperación semántica y léxica, reordena candidatos a través de un servicio separado de Jetson NLP y expone los resultados a través de HTTP y el Protocolo de Contexto de Modelo (MCP).

Está diseñado para un despliegue en una red pequeña y de confianza donde los datos del repositorio deben permanecer bajo el control del operador.

Aspectos destacados

• Contención segura del repositorio bajo una raíz gestionada

• Indexación de confirmaciones limpias con procedencia de archivos, fragmentos, modelos y esquemas

• Reindexación completa autoritativa que elimina puntos obsoletos de Qdrant

• Recuperación híbrida de vectores y ripgrep con fusión de rango recíproco consciente de fragmentos

• Reordenamiento opcional de codificador cruzado a través de Jetson NLP

• Integración ligera de MCP HTTP transmisible con respuestas de herramientas estructuradas

• Estado duradero de trabajos e índices en SQLite

• Configuración YAML validada y registros estructurados de archivos rotativos

• Modelo de indexación serializado de un solo trabajador con límites de recursos explícitos

Related MCP server: Qurio MCP Server

Arquitectura

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 posee la semántica de repositorio, ruta, confirmación, fragmento y recuperación. Jetson NLP sigue siendo un servicio de inferencia sin estado que solo conoce texto, vectores y puntuaciones.

Estructura del repositorio

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 de un vistazo

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
  }'

Cuando se configura security.api_token, agregue Authorization: Bearer <token> a todas las solicitudes de API que no sean de salud.

Rutas de producción

Consulte Despliegue para el procedimiento de instalación completo.

Documentación

• Arquitectura

• Referencia de API

• Configuración

• Despliegue

• Desarrollo

• Integración de MCP

• Operaciones

• Auditoría inicial

Alcance actual

La versión inicial realiza una indexación completa autoritativa. La indexación incremental de Git, la ingesta por webhook, la fragmentación con conocimiento de sintaxis, los gráficos de símbolos y el análisis de referencias son extensiones planificadas, no características reclamadas. Los trabajos de indexación son duraderos para la generación de informes de estado, pero se ejecutan en un solo proceso local; no es una cola de trabajos distribuida.

Los servicios no terminan TLS, y el punto final MCP no implementa autenticación de cliente. Manténgalos en una red privada de confianza o colóquelos detrás de un proxy inverso autenticado. Consulte Seguridad.

Licencia

SourceRecall está disponible bajo la Licencia MIT.