Queryweaver
by falkordbofficialv0.0.11
812
105
QueryWeaver is an open-source Text2SQL tool that converts plain-English questions into SQL using graph-powered schema understanding.
From the registry: An MCP server for Text2SQL: transforms natural language into SQL using graph schema understanding.
Install & configure
Prerequisites
- requiredRun QueryWeaver via DockerQueryWeaver is a full application with its own MCP HTTP surface. Run it locally or use the hosted version.
https://hub.docker.com/r/falkordb/queryweaver/$ docker run -p 5000:5000 -it falkordb/queryweaver - requiredGet a bearer tokenAuthenticate via the web UI (OAuth) or API token endpoint to get a bearer tokenhttps://app.queryweaver.ai
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `queryweaver` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Run QueryWeaver via Docker** — QueryWeaver is a full application with its own MCP HTTP surface. Run it locally or use the hosted version. Run: `docker run -p 5000:5000 -it falkordb/queryweaver` (https://hub.docker.com/r/falkordb/queryweaver/)
- **Get a bearer token** — Authenticate via the web UI (OAuth) or API token endpoint to get a bearer token (https://app.queryweaver.ai)
Canonical MCP server config (HTTP transport):
- url: `http://127.0.0.1:5000/mcp`
- headers:
- `Authorization`: `Bearer <your-token>`
Note: Text2SQL tool using graph-powered schema understanding. Requires a running QueryWeaver instance (Docker or cloud). MCP surface exposes: list_databases, connect_database, database_schema, query_database. Disable MCP with DISABLE_MCP=true.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: Text2SQL tool using graph-powered schema understanding. Requires a running QueryWeaver instance (Docker or cloud). MCP surface exposes: list_databases, connect_database, database_schema, query_database. Disable MCP with DISABLE_MCP=true.
Tools (1)
MCP operations
Includes operations focused on Text2SQL flows such as list_databases, connect_database, database_schema, and query_database.
Environment variables
FASTAPI_SECRET_KEYrequiredUsed for securing the FastAPI application.GOOGLE_CLIENT_IDrequiredClient ID for Google OAuth authentication.GOOGLE_CLIENT_SECRETrequiredClient secret for Google OAuth authentication.GITHUB_CLIENT_IDrequiredClient ID for GitHub OAuth authentication.GITHUB_CLIENT_SECRETrequiredClient secret for GitHub OAuth authentication.AZURE_API_KEYrequiredAPI key for Azure OpenAI services.OPENAI_API_KEYrequiredAPI key for OpenAI services.GEMINI_API_KEYrequiredAPI key for Google Gemini services.Prerequisites
- • Python 3.12+
Packages
docker.io/falkordb/queryweaver:0.0.11
ocitransport: streamable-http
Details
- Language
- TypeScript
- License
- AGPL-3.0
- Released
- Sep 11, 2025
- Last commit
- Apr 9, 2026
- Registry name
- com.falkordb/QueryWeaver