beingdb-mcp

BeingDB HTTP API（find/where クエリ DSL を含む）を MCP 対応 LLM に公開する、軽量な Model Context Protocol（MCP）サーバーです。自然言語からクエリを変換することはなく、接続された LLM が BeingDB の述語（predicates）を発見し、DSL を作成し、beingdb-mcp がそれを検証・実行して結果を返します。透明性のため、実行された正確なクエリは常に含まれます。

はじめに

# 1. Compile your facts into ./pack_store using BeingDB's native CLI
#    (beingdb-compile --git ./git_store --pack ./pack_store)

# 2. Start everything: BeingDB, beingdb-mcp, and an nginx reverse proxy in front of both
docker compose up -d

以上です。beingdb と mcp はどちらもプレーンな HTTP で通信し、nginx（docker-compose.yml/nginx.conf）を介してのみ到達可能で、ホストの :8090 で公開されます：

• BeingDB REST API: http://<host>:8090/...（例：/version、/predicates、/query）

• MCP（Streamable HTTP）: http://<host>:8090/mcp

リモート/HTTP サーバーをサポートする任意の MCP クライアントを、その /mcp URL に直接指定してください。ローカルプロセスの起動や SSH、クライアント側での設定は不要です。nginx.conf には 10 req/s のレート制限（BeingDB 推奨設定に準拠）が追加されています。TLS やアクセス制御を強化する場合は、これを独自の Apache（または他の）vhost の背後に配置してください。beingdb と mcp はどちらもデフォルトで認証なしです（BeingDB の HTTP API と同様）。エンドポイントを完全に公開したくない場合は、前面（Apache/nginx）で認証を追加してください。BeingDB のチェックアウトが ../beingdb にない場合は、docker-compose.yml 内の beingdb サービスの build.context を調整してください。

3つのコンテナすべてに restart: unless-stopped が設定されているため、単一の docker compose up -d コマンドだけでヘッドレスホスト（例：Raspberry Pi）へのデプロイ全体が完了します。一度実行してそのまま起動し続けます（Docker 自体は起動時に開始するよう設定してください）。

Related MCP server: NL-to-SQL MCP

試してみる

beingdb-mcp を試す最も簡単な方法は、ブラウザベースの MCP クライアントを使用することです。MCP Playground Online を開き、以下に接続してください：

rewind.zedstar.org/mcp

すべての beingdb_query / beingdb_validate_query / beingdb_explain_query の結果には、送信された正確な query が含まれます。そのため、LLM が生成した DSL は結果とともに常に確認できます。

ライセンス

MIT