beingdb-mcp

Un servidor ligero del Model Context Protocol (MCP) que expone la API HTTP de BeingDB -- incluyendo su DSL de consultas find/where -- a LLMs compatibles con MCP. No traduce lenguaje natural a consultas por sí mismo: el LLM conectado descubre los predicados de BeingDB, escribe el DSL, y beingdb-mcp lo valida/ejecuta a través de BeingDB y devuelve los resultados, incluyendo siempre la consulta exacta que ejecutó para mayor transparencia.

Primeros pasos

# 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

Eso es todo -- tanto beingdb como mcp hablan HTTP plano y solo son accesibles a través de nginx (docker-compose.yml/nginx.conf), publicados en el host en :8090:

• API REST de BeingDB: http://<host>:8090/... (p. ej. /version, /predicates, /query)

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

Apunte cualquier cliente MCP que admita un servidor remoto/HTTP directamente a esa URL /mcp -- sin generación de procesos locales, sin SSH, nada que configurar del lado del cliente más allá de la URL. nginx.conf añade un límite de 10 req/s (coincidiendo con la configuración recomendada por BeingDB) -- colóquelo detrás de su propio vhost de Apache (u otro) para TLS/control de acceso adicional. Tanto beingdb como mcp no están autenticados por diseño (igual que la propia API HTTP de BeingDB); añada autenticación al frente (Apache/nginx) si no desea que el endpoint sea completamente público. Ajuste el build.context del servicio beingdb en docker-compose.yml si su copia de BeingDB no está en ../beingdb.

restart: unless-stopped en los tres contenedores significa que un solo docker compose up -d es todo el paso de despliegue en un host sin cabeza (por ejemplo, una Raspberry Pi) -- ejecútelo una vez y déjelo corriendo (con Docker configurado para iniciarse al arrancar).

Related MCP server: NL-to-SQL MCP

Pruébelo

La forma más fácil de explorar beingdb-mcp es con un cliente MCP basado en navegador. Abra MCP Playground Online y conéctese a:

rewind.zedstar.org/mcp

Cada resultado de beingdb_query/beingdb_validate_query/beingdb_explain_query incluye la query exacta enviada, por lo que el DSL generado por un LLM siempre es visible junto con sus resultados.

Licencia

MIT