# QueryWeaver

QueryWeaver turns plain-language database questions into SQL and returns results. Use it when an agent needs to inspect schemas and query data through MCP.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 1086
- Author: FalkorDB
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/FalkorDB/QueryWeaver
- Updated: 2026-10-19
- HTML: https://affpapa.org/en/nevibecode/mcp/queryweaver

## What it does

QueryWeaver is an open-source MCP server for Text2SQL. It treats the database schema as a graph, accepts a natural-language question, and produces SQL with the result. Its MCP interface includes `list_databases`, `connect_database`, `database_schema`, and `query_database`.

Run the server in Docker on `localhost:5000`, then connect an MCP client to its HTTP surface at `/mcp`. The client configuration uses `mcp.json`, the server URL, and a Bearer token. QueryWeaver also exposes a REST API for schema graphs and streaming Text2SQL queries.

QueryWeaver connects to FalkorDB during startup, so it will not start without FalkorDB. Model access can use `OPENAI_API_KEY`, `GEMINI_API_KEY`, `ANTHROPIC_API_KEY`, or `AZURE_API_KEY`; configuration can be supplied through `.env`.

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- turn a database question into SQL
- inspect tables, columns, and foreign keys
- run a Text2SQL query against a selected graph
- connect an MCP client to an HTTP server
- retrieve database schema data for an agent

## Example prompts
- Show me the schema of the connected database and list its tables.
- Find the records that answer this question and run the SQL query.
- Connect to the database, select the right graph, and explain the query result.

## Similar
- [postgres](https://affpapa.org/en/nevibecode/skills/postgres.md) — skill · 1400 installs
- [prisma-driver-adapter-implementation](https://affpapa.org/en/nevibecode/skills/prisma-driver-adapter-implementation.md) — skill · 376900 installs
- [firebase-data-connect](https://affpapa.org/en/nevibecode/skills/firebase-data-connect.md) — skill · 168800 installs
- [neon-postgres-egress-optimizer](https://affpapa.org/en/nevibecode/skills/neon-postgres-egress-optimizer.md) — skill · 29300 installs
- [sql-optimization-patterns](https://affpapa.org/en/nevibecode/skills/sql-optimization-patterns.md) — skill · 19717 installs
- [clickhouse-architecture-advisor](https://affpapa.org/en/nevibecode/skills/clickhouse-architecture-advisor.md) — skill · 9800 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md