beingdb-mcp

Ein schlanker Model Context Protocol (MCP)-Server, der die HTTP-API von BeingDB – einschließlich dessen find/where-Abfrage-DSL – für MCP-fähige LLMs bereitstellt. Er übersetzt selbst keine natürliche Sprache in Abfragen: Das verbundene LLM entdeckt BeingDBs Prädikate, schreibt das DSL, und beingdb-mcp validiert/führt es über BeingDB aus und gibt die Ergebnisse zurück, wobei die exakte ausgeführte Abfrage stets zur Transparenz beigefügt ist.

Erste Schritte

# 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

Das war's – sowohl beingdb als auch mcp kommunizieren über reines HTTP und sind nur über nginx erreichbar (docker-compose.yml/nginx.conf), veröffentlicht auf dem Host unter :8090:

• BeingDB's REST-API: http://<host>:8090/... (z.B. /version, /predicates, /query)

• MCP (Streamable HTTP): http://<host>:8090/mcp

Richten Sie jeden MCP-Client, der einen Remote/HTTP-Server unterstützt, direkt auf diese /mcp-URL aus – kein lokaler Prozess-Spawn, kein SSH, nichts Client-seitig zu konfigurieren außer der URL. nginx.conf fügt eine Rate-Limit von 10 req/s hinzu (entsprechend BeingDB's eigener empfohlener Konfiguration) – setzen Sie dies hinter Ihren eigenen Apache (oder anderen) vhost für TLS/weitere Zugriffskontrolle. Sowohl beingdb als auch mcp sind standardmäßig unauthentifiziert (genau wie BeingDB's eigene HTTP-API); fügen Sie davor Authentifizierung hinzu (Apache/nginx), wenn Sie den Endpunkt nicht vollständig öffentlich haben möchten. Passen Sie den build.context des beingdb-Dienstes in docker-compose.yml an, wenn sich Ihr BeingDB-Checkout nicht unter ../beingdb befindet.

restart: unless-stopped auf allen drei Containern bedeutet, dass ein einzelnes docker compose up -d der gesamte Bereitstellungsschritt auf einem kopflosen Host (z.B. einem Raspberry Pi) ist – führen Sie es einmal aus und lassen Sie es laufen (wobei Docker selbst so eingestellt ist, dass es beim Start startet).

Related MCP server: NL-to-SQL MCP

Ausprobieren

Der einfachste Weg, beingdb-mcp zu erkunden, ist mit einem browserbasierten MCP-Client. Öffnen Sie MCP Playground Online und verbinden Sie sich mit:

rewind.zedstar.org/mcp

Jedes Ergebnis von beingdb_query/beingdb_validate_query/beingdb_explain_query enthält die exakt übermittelte query, sodass das von einem LLM generierte DSL stets zusammen mit seinen Ergebnissen sichtbar ist.

Lizenz

MIT