beingdb-mcp

BeingDB의 HTTP API(해당 find/where 쿼리 DSL 포함)를 MCP 지원 LLM에 노출하는 경량 Model Context Protocol (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에 게시됩니다.

• BeingDB의 REST API: http://<host>:8090/... (예: /version, /predicates, /query)

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

원격/HTTP 서버를 지원하는 모든 MCP 클라이언트를 해당 /mcp URL에 직접 연결하세요. 로컬 프로세스 생성, SSH, URL 외에 클라이언트 측에서 구성할 것이 없습니다. nginx.conf는 10 req/s 속도 제한을 추가합니다(BeingDB 자체 권장 구성과 일치). TLS/추가 액세스 제어를 위해 이를 자체 Apache(또는 다른) vhost 뒤에 배치하세요. beingdb와 mcp는 모두 설계상 인증이 없습니다(BeingDB 자체 HTTP API와 동일). 엔드포인트를 완전히 공개하고 싶지 않다면 앞단(Apache/nginx)에 인증을 추가하세요. BeingDB 체크아웃이 ../beingdb에 없는 경우 docker-compose.yml에서 beingdb 서비스의 build.context를 조정하세요.

세 컨테이너 모두에 restart: unless-stopped가 설정되어 있으므로 헤드리스 호스트(예: Raspberry Pi)에서 docker compose up -d 한 번으로 전체 배포 단계가 완료됩니다. 한 번 실행하고 계속 실행 상태로 두세요(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