Boop MCP–RAG

Boop MCP–RAG は、将来の検索拡張生成（RAG）および Model Context Protocol（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

このサーバーでは、次の4つのローカル参照ツールを公開します:

インストール境界

config.example.json をコピーし、対象となるランタイム、データソース、アクセス境界、運用要件を検証した後でのみ、実際のアダプターを選択してください。このリポジトリにシークレット、サービストークン、ソースダンプ、本番の接続文字列を置かないでください。