Boop MCP–RAG

Boop MCP–RAG는 향후 RAG(Retrieval-Augmented Generation) 및 MCP(Model Context Protocol) 시스템을 위한 소스 독립적 기반입니다. 모델 프로바이더, 소스 시스템, 자격 증명, 데이터베이스, 벡터 데이터베이스, 원격 MCP 서버 또는 프로덕션 ID 서비스를 내장하지 않고, 안정적인 계약과 결정론적 로컬 참조 경로를 구현합니다.

이 프로젝트는 의도적으로 구조적 기반입니다. 프로덕션 RAG 서비스, 자율 에이전트, API 게이트웨이, 벡터 검색 클러스터 또는 원격 도구 실행기가 아닙니다.

런타임 토폴로지

Consumer / MCP client
        |
        v
ContextRouter
   |                  |
   v                  v
QueryRetriever      MCPHost
   |                  |
   v                  v
ContextDocument     ToolResult
        \            /
         v          v
      ContextPayload

오케스트레이터는 정규화된 계약만 바라봅니다. 검색 저장소, 세션 영속성, 도구 전송, 텔레메트리 내보내기는 설치 시점에 인터페이스 뒤에서 선택됩니다.

Related MCP server: Local RAG MCP Server

포함된 동작

ContextRouter는 요청을 검증하고, 컨텍스트를 검색하며, 등록된 도구를 발견합니다. 그리고 호출자가 명시적으로 requested_tool을 제공하는 경우에만 도구를 실행합니다. 또한 사용자 쿼리, 검색된 문서, 도구 정의, 세션 메타데이터, 선택적 도구 결과를 포함하는 정규화된 ContextPayload를 생성합니다.

참조 지식 어댑터는 결정론적 키워드 매칭입니다. 계약과 테스트를 검증하기 위해 제공되며, 시맨틱/벡터 검색을 주장하기 위한 것이 아닙니다. 로컬 MCP 호스트는 핸들러를 호출하기 전에 Pydantic으로 모든 도구 입력값을 검증합니다.

설치 및 검증

python3 -m pip install -e .
python3 -m unittest discover -s tests -p "test_*.py" -v
python3 -m compileall -q src tests server.py
boop-mcp-rag status

로컬 MCP 인터페이스

로컬 MCP 서버를 시작합니다:

mcp run server.py

다음 네 가지 로컬 참조 도구를 제공합니다:

설치 경계

config.example.json을 복사하고, 대상 런타임, 데이터 소스, 접근 경계, 운영 요구 사항을 확인한 후에만 실제 어댑터를 선택하십시오. 이 저장소에 비밀, 서비스 토큰, 소스 덤프 또는 프로덕션 연결 문자열을 넣지 마십시오.