Boop MCP–RAG

Boop MCP–RAG 是一个与数据源无关的基础框架，为未来的检索增强生成（RAG）与模型上下文协议（MCP）系统提供结构基础。它在不模型提供方、数据源、凭据、数据库、向量数据库、远程 MCP 服务器或生产环境身份服务的前提下，实现了稳定的契约和确定性的本地参考路径。

该项目刻意定位为结构基础。它不是生产级 RAG 服务、自主智能体、API 网关、向量检索集群或远程工具执行器。

运行时拓扑

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

提供方，检索存储、会话持久化、工具传输和遥测导出均在安装时通过接口选配。

Related MCP server: DocAgent-MCP

行为

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

安装边界

应根据已验证的目标运行时、数据源、访问边界和运维要求，仅在此之后拷贝配置文件副本并选择真实的实现，避免本仓库包含任何密钥、机密字段、数据源转储或生产连接字符串。