beingdb-mcp

Тонкий сервер Model Context Protocol (MCP), который предоставляет HTTP API BeingDB — включая его DSL запросов find/where — для LLM, поддерживающих MCP. Он не переводит естественный язык в запросы сам по себе: подключенная LLM обнаруживает предикаты BeingDB, пишет DSL, а beingdb-mcp проверяет/выполняет его через BeingDB и возвращает результаты, всегда включая точный выполненный запрос для прозрачности.

Начало работы

# 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:

• REST API BeingDB: http://<host>:8090/... (например, /version, /predicates, /query)

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

Направьте любой MCP-клиент, поддерживающий удаленный/HTTP сервер, непосредственно на этот URL /mcp — без запуска локальных процессов, без SSH, без настройки на стороне клиента, кроме URL. nginx.conf добавляет ограничение скорости 10 запросов/с (в соответствии с рекомендуемой конфигурацией самого BeingDB) — поместите это за свой собственный Apache (или другой) виртуальный хост для TLS/дополнительного контроля доступа. И beingdb, и mcp не требуют аутентификации по замыслу (как и собственный HTTP API BeingDB); добавьте аутентификацию перед ними (Apache/nginx), если не хотите, чтобы конечная точка была полностью публичной. Настройте build.context сервиса beingdb в docker-compose.yml, если ваш репозиторий BeingDB находится не в ../beingdb.

restart: unless-stopped для всех трех контейнеров означает, что одной команды docker compose up -d достаточно для всего развертывания на безголовом хосте (например, Raspberry Pi) — запустите его один раз и оставьте работать (при условии, что сам Docker настроен на запуск при загрузке).

Related MCP server: mcp-sparql

Попробуйте

Самый простой способ изучить beingdb-mcp — использовать MCP-клиент на базе браузера. Откройте MCP Playground Online и подключитесь к:

rewind.zedstar.org/mcp

Каждый результат beingdb_query/beingdb_validate_query/beingdb_explain_query включает точный отправленный query, поэтому DSL, сгенерированный LLM, всегда отображается вместе с его результатами.

Лицензия

MIT