QueryWeaver MCP Server

An MCP server for Text2SQL: transforms natural language into SQL using graph schema understanding.

Local serverstdioPython

What is the QueryWeaver MCP Server?

An MCP server for Text2SQL: transforms natural language into SQL using graph schema understanding.

What the server does

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.

QueryWeaver exposes a small REST API for managing graphs (database schemas) and running Text2SQL queries. All endpoints that modify or access user-scoped data require authentication via a bearer token. In the browser the app uses session cookies and OAuth flows; for CLI and scripts you can use an API token (see tokens routes or the web UI to create one).

Credentials and setup notes

  • Python 3.12+ - FalkorDB instance (local or remote) - OpenAI or Azure OpenAI API key (for LLM) - Target SQL database (PostgreSQL or MySQL)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the QueryWeaver MCP Server

{
  "mcpServers": {
    "queryweaver": {
      "command": "uvx",
      "args": ["queryweaver"],
      "env": {
        "FASTAPI_SECRET_KEY": "your-value",
        "GOOGLE_CLIENT_ID": "your-value",
        "GOOGLE_CLIENT_SECRET": "your-value",
        "GITHUB_CLIENT_ID": "your-value",
        "GITHUB_CLIENT_SECRET": "your-value",
        "AZURE_API_KEY": "your-value",
        "OPENAI_API_KEY": "your-value",
        "GEMINI_API_KEY": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • Python 3.12+ - FalkorDB instance (local or remote) - OpenAI or Azure OpenAI API key (for LLM) - Target SQL database (PostgreSQL or MySQL)
VariableDescriptionRequired
FASTAPI_SECRET_KEYCredential the server authenticates with.Yes
GOOGLE_CLIENT_IDConfiguration value read at startup.Optional
GOOGLE_CLIENT_SECRETCredential the server authenticates with.Yes
GITHUB_CLIENT_IDConfiguration value read at startup.Optional
GITHUB_CLIENT_SECRETCredential the server authenticates with.Yes
AZURE_API_KEYCredential the server authenticates with.Yes
OPENAI_API_KEYCredential the server authenticates with.Yes
GEMINI_API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • “Use QueryWeaver to Overview.”
  • “Use QueryWeaver to Installation.”
  • “Use QueryWeaver to Requirements.”

Frequently asked questions

An MCP server for Text2SQL: transforms natural language into SQL using graph schema understanding. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.