SourceRecall

SourceRecall — это самостоятельно размещаемый сервис интеллектуального анализа репозиториев для ИИ-ассистентов программирования. Он индексирует чистые рабочие деревья Git в Qdrant, объединяет семантический и лексический поиск, переранжирует кандидатов через отдельный сервис Jetson NLP и предоставляет результаты через HTTP и Model Context Protocol (MCP).

Он предназначен для развёртывания в небольшой доверенной сети, где данные репозитория должны оставаться под контролем оператора.

Особенности

• Безопасное изолирование репозиториев под единым управляемым корным каталогом

• Индексация чистых коммитов с провенансом фалов, чанков, моделей и схем

• Полная переиндексация, удаляющая устаревшие точки Qdrant

• Гибридный весторный и ripgrep поиск с чанко-осведомленным взвешенным слиянием Reciprocal Rank Fusion

• Опциональное переранжирование через cross-encoder в Jetson NLP

• Тонкая интеграция Streamable HTTP MCP со структурированными ответами инструментов

• Надежное состояние заданий и индекса в SQLite

• Валидированная YAML-конфигурация и структурированные лог-файлы с ротацией

• Однорабочий, сериализованный режм индексации с явными огранчениями ресусов

Related MCP server: Qurio MCP Server

Архитектура

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 управляет семантикой репозиториев, путей, коммитов, чанков и поиска. Jetson NLP остается статессным сервисом инференции, который знает только текст, весторы и оченки.

Структура репозитория

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 к рamятке

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

Когда security.api_token настроен, добавляйте Authorization: Bearer <token> ко всем не-хелсовым API-запросам.

Промышленные пути

См. Dissection для полной процедуры установки.

Документация

• Архитектура

• Справочник API

• Конфигурация

• Развертывание

• Разработка

• Интеграция MCP

• Операции

• Первичный аудит

Текущая область применения

Первый релиз выполняет полную индексацию в авторитетном режиме. Инкрементальная индексация Git, прием через вебхуки, синтаксически осознанное разбиение на чанки, графы символов и анализ ссылок являются планируемыми расширениями, а не заявленными функциями. Задания индексации долговечны для отслеживания статуса, но выполняются в одном локальном процессе; это не рапределенная очередь заданий.

Сервисы не завершают TLS, а MCP-ендпоинт не реализует аутентификацию клиента. Держите их в защищенной частной сети или за аутентифицированным реверс-прокси. См. Безопасность.

Лицензия

SourceRecall доступен по лицензии MIT.