Description

QueryWeaver is a text-to-SQL system that combines FastAPI with graph-powered schema understanding using FalkorDB to enable natural language database querying. The implementation features PostgreSQL and MySQL schema loaders that extract database structures into graph representations with vector embeddings, multi-agent query processing pipeline with analysis, relevancy checking, and response formatting agents, and OAuth-based authentication with API token management. Built with a modular architecture supporting both web interface and MCP protocol integration, it enables use cases like business intelligence queries, database exploration, and automated report generation by translating conversational questions into accurate SQL queries while maintaining context across query sessions.

Installation

git clone https://github.com/falkordb/queryweaver

Claude Desktop Configuration

Add this configuration to your Claude Desktop config file to enable this MCP server:

Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json

Config file location: %APPDATA%\Claude\claude_desktop_config.json

Config file location: ~/.config/Claude/claude_desktop_config.json

claude_desktop_config.json
{
  "mcpServers": {
    "queryweaver": {
      "command": "node",
      "args": [
        "path/to/server.js"
      ]
    }
  }
}