SourceRecall

SourceRecall은 AI 코딩 어시스턴트를 위한 자체 호스팅 저장소 인텔리전스 서비스입니다. 깔끔한 Git 워킹 트리를 Qdrant에 인덱싱하고, 의미적 검색과 어휘 검색을 결합하며, 별도의 Jetson NLP 서비스를 통해 후보를 재순위화하고, HTTP와 Model Context Protocol(MCP)을 통해 결과를 제공합니다.

운영자가 저장소 데이터를 제어해야 하는 소규모 신뢰 네트워크 배포를 위해 설계되었습니다.

주요 기능

• 하나의 관리 루트 아래 안전한 저장소 격리

• 파일, 청크, 모델 및 스키마 출처를 포함한 깨끗한 커밋 인덱싱

• 오래된 Qdrant 포인트를 제거하는 권위적인 전체 재인덱싱

• 청크 인식 상호 순위 융합을 통한 하이브리드 벡터 및 ripgrep 검색

• Jetson NLP를 통한 선택적 교차 인코더 재순위화

• 구조화된 도구 응답을 지원하는 경량 Streamable HTTP MCP 통합

• 내구성 있는 SQLite 작업 및 인덱스 상태

• 검증된 YAML 구성 및 구조화된 순환 로그 파일

• 명시적인 리소스 제한이 있는 단일 작업자 직렬화 인덱싱 모델

Related MCP server: Claude Context MCP

아키텍처

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 개요

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이 설정된 경우 모든 비상태 API 요청에 Authorization: Bearer <token>을 추가하세요.

프로덕션 경로

자세한 설치 절차는 Deployment를 참조하세요.

문서

• Architecture

• API reference

• Configuration

• Deployment

• Development

• MCP integration

• Operations

• Initial audit

현재 범위

초기 릴리스는 권위적인 전체 인덱싱을 수행합니다. 증분 Git 인덱싱, 웹훅 수집, 구문 인식 청킹, 심볼 그래프 및 참조 분석은 현재 기능이 아닌 확장 계획입니다. 인덱싱 작업은 상태 보고를 위해 내구성이 있지만 로컬 프로세스 하나에서 실행됩니다. 이는 분산 작업 큐가 아닙니다.

서비스는 TLS를 종료하지 않으며 MCP 엔드포인트는 클라이언트 인증을 구현하지 않습니다. 신뢰할 수 있는 사설 네트워크에 두거나 인증된 리버스 프록시 뒤에 배치하세요. Security를 참조하세요.

라이선스

SourceRecall은 MIT License 하에 제공됩니다.