Boop MCP–RAG

Boop MCP–RAG es una base independiente de la fuente para un futuro sistema de generación aumentada por recuperación (RAG) y protocolo de contexto de modelo (MCP). Implementa contratos estables y una ruta de referencia local determinista sin incorporar un proveedor de modelos, un sistema de origen, una credencial, una base de datos, un almacén vectorial, un servidor MCP remoto ni un servicio de identidad de producción.

El proyecto es deliberadamente una base estructural. No es un servicio RAG de producción, un agente autónomo, una puerta de enlace de API, un clúster de búsqueda vectorial ni un ejecutor remoto de herramientas.

Topología de ejecución

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

El orquestador solo ve contratos normalizados. El almacenamiento de la recuperación, la persistencia de sesión, el transporte de herramientas y la exportación de telemetría se seleccionan detrás de interfaces en el momento de la instalación.

Related MCP server: DocAgent-MCP

Comportamiento incluido

El ContextRouter valida una solicitud, recupera el contexto, descubre las herramientas registradas y ejecuta una herramienta solo cuando quien la llama proporciona explícitamente requested_tool. Crea un ContextPayload normalizado que contiene la consulta del usuario, los documentos recuperados, las definiciones de herramientas, los metadatos de sesión y un resultado de herramienta opcional.

El adaptador de conocimiento de referencia es una coincidencia determinista de palabras clave. Se proporciona para validar contratos y pruebas, no para afirmar una recuperación semántica/vectorial. El host local de MCP valida cada entrada de herramienta con Pydantic antes de invocar su controlador.

Instalar y validar

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

Interfaz local de MCP

Inicia el servidor local de MCP:

mcp run server.py

Expone cuatro herramientas de referencia local:

Límite de instalación

Copia config.example.json y selecciona los adaptadores reales solo después de verificar el entorno de ejecución de destino, las fuentes de datos, el límite de acceso y los requisitos operativos. No incluyas secretos, tokens de servicio, volcados de fuente ni cadenas de conexión de la ducción en este reproductorio.