Boop MCP–RAG

Boop MCP–RAG ist eine quellenunabhängige Grundlage für ein zukünftiges System zur Retrieval-Augmented Generation (RAG) und zum Model Context Protocol (MCP). Es implementiert stabile Verträge und einen deterministischen, lokalen Referenzpfad, ohne Modellanbietersystem, Quellsystem, Zugangsdaten-Speicher, Datenbank, Vektordatenbank, Remote-MCP-Server oder Identitätsdienst für den Echtbetrieb einzubetten.

Das Projekt ist bewusst ein strukturelles Fundament. Es ist kein Produktions-RAG-Dienst, kein autonomer Agent, kein API-Gateway, kein Vektorsuch-Cluster und kein Executor für Remote-Tools.

Laufzeittopologie

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

Der Orchestrator sieht ausschließlich normalisierte Verträge. Retrieval-Speicher, Sitzungspersistenz, Tool-Transport und Telemetrie-Export werden zur Installationszeit hinter Schnittstellen ausgewählt.

Related MCP server: DocAgent-MCP

Implementiertes Verhalten

Der ContextRouter validiert eine Anfrage, ruft Kontext ab, deckt registrierte Tools auf und führt ein Tool ausschließlich dann aus, wenn der Aufrufer requested_tool explizit bereitstellt. Er erzeugt ein normalisiertes ContextPayload mit der Benutzeranfrage, den abegerufenen Dokumenten, den Tool-Definitionen, den Sitzungs-Metadaten und einem optionalen Tool-Ergebnis.

Der deterministische Referenz-Wissensadapter gleicht Schlüsselwörter ab. Er dient der Validierung von Verträgen und Tests, nicht der Bereitstellung semantischer oder vektorbasierter Suche. Der lokale MCP-Host validiert jede Tool-Eingabe mit Pydantic, bevor er den zugehörigen Handler aufruft.

Installation und Validierung

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

Lokale MCP-Oberfläche

Start Sie den lokalen MCP-Server:

mcp run server.py

Er weißt vier lokale Referenz-Toole aus:

Installationgrenze

Kopieren Sie config.example.json und wählen Sie reale Adapter erst aus, wenn die zielgerichtete Laufzeitumgebung, Datenquellen, Zugriffsgrenze und betriebliche Anforderungen verifiziert sind. Legen Sie keine Geheimnisse, Diensttokens, Quellablagen oder Produktions-Verbindungsstrings in diesem Repository ab.