Query Weaver MCP Server

REST API · MCP · Graph-powered QueryWeaver is an open-source Text2SQL tool that converts plain-English questions into SQL using graph-powered schema understanding. It helps you ask databases natural-language questions and returns SQL and results.

People who work with falkordb, semantic layer and text2sql and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-09-16 · ★ 1,076 · #38 OF 168 MAINTAINED DATABASE · VERIFIED 2026-09-18

AGPL-3.0 · Python servers · how we verify → /methodology

01 · Install Query Weaver

before you install - you'll need

Set MEMORY_TTL_SECONDS, APP_ENV, COMPLETION_MODEL, EMBEDDING_MODEL, FASTAPI_SECRET_KEY, GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GITHUB_CLIENT_ID, GITHUB_CLIENT_SECRET, AZURE_API_KEY, OPENAI_API_KEY before connecting. DISABLE_MCP is optional or environment-specific per the README.

Docker

docker run -i --rm docker.io/falkordb/queryweaver:0.0.11

Claude Desktop - add to config

{
  "mcpServers": {
    "falkordb-queryweaver": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/falkordb/queryweaver:0.0.11"
      ]
    }
  }
}

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as container (OCI image) - can be sandboxed away from your filesystem

license AGPL-3.0 - declared in the repository

registry vendor namespace com.falkordb - domain-verified with the official MCP registry

03 · What Query Weaver can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v0.3.2 · 2026-08-18

staging v0.3.1 · bump mcp from 1.26.0 to 1.27.2 in the uv group across 1 directory · combine open Dependabot updates · combine open Dependabot updates · Remove redundant community health files in favour of org-wide…

0.3.1 · 2026-07-16

SDK now publishes to PyPI - · ## What is new · - Always-on per-query usage tracking. #614 · - New unauthenticated /version endpoint; version single-sourced in queryweaver/__init__.py. #584 · ## Security · - Hardened…

0.0.14 · 2026-01-08

rebased staging from Main · Add concurrency settings to Playwright workflow · Update demo GIF in README · improve mobile UI spacing and header layout · Fix E2E tests · Fix E2E tests · Add database feedback · Add…

04 · Who maintains Query Weaver

QueryWeaver is maintained by falkordb. It's the only MCP server we track from this author; the repo dates to Jul 2025.

05 · Facts

repository: github.com/falkordb/queryweaver
category: database - ranked #38 of 168 actively-maintained database servers as of 2026-09-18.
release cadence: 2 releases in the last 90 days (latest 2026-08-18)
registry: com.falkordb/QueryWeaver (active, first published 2025-09-11)
packages: oci:docker.io/falkordb/queryweaver:0.0.11

06 · Query Weaver FAQ

What is Query Weaver?

Is Query Weaver still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-16 and it shipped 2 releases in the last 90 days. We re-verify nightly.

How do I install Query Weaver?

Run `docker run -i --rm docker.io/falkordb/queryweaver:0.0.11`. The README documents 12 environment variables (MEMORY_TTL_SECONDS, APP_ENV, COMPLETION_MODEL…) to set first. Set MEMORY_TTL_SECONDS, APP_ENV, COMPLETION_MODEL, EMBEDDING_MODEL, FASTAPI_SECRET_KEY, GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GITHUB_CLIENT_ID, GITHUB_CLIENT_SECRET, AZURE_API_KEY, OPENAI_API_KEY before connecting. DISABLE_MCP is optional or environment-specific per the README. You can also paste the ready-made client config above.

07 · Alternatives to Query Weaver

Alternatives to Query Weaver

Maintained database servers if Query Weaver isn't the fit.

Pairs well with

Servers that cover what Query Weaver doesn't - only shown when the pairing reason fits the companion.

More database MCP servers · Bibelstudium MCP · Kin · Florentine Ai MCP Server · Islam West Africa Collection (IWAC) · Django ORM Lens

More Python MCP servers · Aurora · Document to JSON – PDF Invoice/Statement/Contract Parser · Log Analyzer MCP · Proton Safe MCP · Aihawk · see all