Atlas / MCP servers / falkordb / QueryWeaver

QueryWeaverBLOCK

mcp/falkordb/queryweaver

An open-source Text2SQL tool that transforms natural language into SQL using graph-powered schema understanding. Ask your database questions in plain English, QueryWeaver handles the weaving.

Verdict
BLOCK
Grade
D
Trust score
61 /100
Exposed tools
—
Transport
streamable-http
License
AGPL-3.0
Stars
1,080
01

Overview

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

QueryWeaver (Text2SQL)

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.

Connect and ask questions: [](https://discord.gg/b32KEzMzce)

[](https://app.falkordb.cloud) [](https://pypi.org/project/queryweaver/) [](https://hub.docker.com/r/falkordb/queryweaver/) [](https://github.com/FalkorDB/QueryWeaver/actions/workflows/tests.yml) [](https://app.queryweaver.ai/docs)

Get Started

Docker

💡 Recommended for evaluation purposes (Local Python or Node are not required)
docker run -p 5000:5000 -it falkordb/queryweaver

Launch: http://localhost:5000

Use an .env file (Recommended)

Create a local .env by copying .env.example and passing it to Docker. This is the simplest way to provide all required configuration:

cp .env.example .env
# edit .env to set your values, then:
docker run -p 5000:5000 --env-file .env falkordb/queryweaver

Alternative: Pass individual environment variables

If you prefer to pass variables on the command line, use -e flags (less convenient for many variables):

docker run -p 
Read from source at commit 2a55c41d7ed2OBSERVED · 2026-09-25
02

Connect

Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.

claude-code
claude mcp add queryweaver --env ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY} --env AZURE_API_KEY=${AZURE_API_KEY} --env COHERE_API_KEY=${COHERE_API_KEY} --env EMAIL_AUTH_ENABLED=${EMAIL_AUTH_ENABLED} -- uvx queryweaver
claude-desktop
{
  "mcpServers": {
    "queryweaver": {
      "command": "uvx",
      "args": [
        "queryweaver"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "${ANTHROPIC_API_KEY}",
        "AZURE_API_KEY": "${AZURE_API_KEY}",
        "COHERE_API_KEY": "${COHERE_API_KEY}",
        "EMAIL_AUTH_ENABLED": "${EMAIL_AUTH_ENABLED}"
      }
    }
  }
}
03

Trust audit

BLOCKgrade D · trust 61/100 Do not install this without reading the findings. The audit found something that could harm you or your machine.

LayerWhat it checksResult
L0Provenance & inventoryWARN
L1Static analysis of the codeFAIL
L2Instruction surface (what it tells the agent)PASS
L3Class-specific surfacePASS
L4Behavioural (sandbox)SKIPPED

What the source does

Filesystem
declared (3 observation(s))
Network
declared (10 observation(s))
Shell
none-observed
Dependencies
not all pinned
Secrets in source
found

Findings (25)

HIGHSupply chain · supply.typosquat · CWE-829, CWE-1357
app/package.json
preact ~ react
Why it matters. dependency name one edit from a popular package
Fix. verify the package; likely typosquat
MEDIUMInventory / provenance · inv.binary · CWE-1104
wordlist.dic
wordlist.dic
Why it matters. a compiled or binary member cannot be reviewed from source
Fix. ship source, or explain the binary in the README
MEDIUMNetwork egress · net.raw_ip · CWE-200, CWE-319
app/vite.config.ts:13
target: 'http://127.0.0.1:5000',
MEDIUMNetwork egress · net.raw_ip · CWE-200, CWE-319
app/vite.config.ts:19
target: 'http://127.0.0.1:5000',
MEDIUMHard-coded secrets · secret.db_uri · CWE-798, CWE-321
.github/workflows/tests.yml:145
TEST_POSTGRES_URL: postgresql://postgres:postgres@localhost:5432/testdb
MEDIUMHard-coded secrets · secret.db_uri · CWE-798, CWE-321
.github/workflows/tests.yml:146
TEST_MYSQL_URL: mysql://root:root@localhost:3306/testdb
MEDIUMHard-coded secrets · secret.db_uri · CWE-798, CWE-321
docs/postgres_loader.md:30
connection_url = "postgresql://postgres:password@localhost:5432/mydatabase"
MEDIUMHard-coded secrets · secret.db_uri · CWE-798, CWE-321
docs/postgres_loader.md:44
const connectionUrl = "postgresql://postgres:password@localhost:5432/mydatabase";
MEDIUMHard-coded secrets · secret.db_uri · CWE-798, CWE-321
docs/postgres_loader.md:56
String connectionUrl = "postgresql://postgres:password@localhost:5432/mydatabase";
MEDIUMHard-coded secrets · secret.generic · CWE-798, CWE-321
tests/test_email_signup.py:71
password="attacker-password-123",
LOWInventory / provenance · inv.symlink · CWE-1104
CLAUDE.md
CLAUDE.md
Why it matters. link not followed
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
e2e/logic/api/apiCalls.ts:4
import { getRequest, postRequest, deleteRequest } from "../../infra/api/apiRequests";
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
e2e/logic/api/apiCalls.ts:5
import { getBaseUrl } from "../../config/urls";
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
e2e/logic/api/mailbox.ts:4
import { postRequest } from '../../infra/api/apiRequests';
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
e2e/logic/api/mailbox.ts:5
import { getBaseUrl } from '../../config/urls';
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
e2e/logic/pom/homePage.ts:2
import { waitForElementToBeVisible, waitForElementToBeEnabled } from "../../infra/utils";
LOWNetwork egress · net.raw_ip · CWE-200, CWE-319
.github/copilot-instructions.md:339
"url": "http://127.0.0.1:5000/mcp",
LOWNetwork egress · net.raw_ip · CWE-200, CWE-319
.github/copilot-instructions.md:358
"servers": {"queryweaver": {"type":"http","url":"http://127.0.0.1:5000/mcp","headers":{"Authorization":"Bearer ${MQW_TOKEN}"}}},
LOWNetwork egress · net.raw_ip · CWE-200, CWE-319
README.md:117
"url": "http://127.0.0.1:5000/mcp",
LOWObfuscation / stealth · obf.decode_call · CWE-506, CWE-94
api/loaders/snowflake_loader.py:228
pem_bytes = base64.b64decode(cleaned_b64)
LOWObfuscation / stealth · obf.decode_call · CWE-506, CWE-94
api/routes/auth.py:142
stored_password = bytes.fromhex(stored_password_hex)
LOWObfuscation / stealth · obf.decode_call · CWE-506, CWE-94
api/routes/usage_tracking.py:84
email = base64.b64decode(user_id, validate=True).decode("utf-8")
LOWSupply chain · supply.unpinned · CWE-829, CWE-1357
app/package.json
@falkordb/canvas, @hookform/resolvers, @radix-ui/react-accordion, @radix-ui/react-alert-dialog, @radix-ui/react-aspect-ratio, @radix-ui/react-avatar, @radix-ui/react-checkbox, @radix-ui/react-collapsi
Why it matters. 73 dependency range(s) float
Fix. pin exact versions or ship a lockfile
LOWSupply chain · supply.unpinned · CWE-829, CWE-1357
package.json
@playwright/test, @types/node, playwright
Why it matters. 3 dependency range(s) float
Fix. pin exact versions or ship a lockfile
LOWInventory / provenance · mcp.no_tools_extracted · CWE-1104
server.json
Why it matters. the tool list is enumerated at runtime by tools/list, not declared in source
Fix. the page says so rather than showing an empty table

Gates applied: no_behavioural_pass.

Audited 2026-09-25 · audit v0.4.1 · source sha 2a55c41d7ed2full audit observations/trust-audit/mcp-server/falkordb__queryweaver.json · Report an issue / request a re-scan
04

Audit history

Every audit this server has had. A grade with a past is a grade somebody is still checking.

DateSourceVerdictGradeScoreChange
2026-09-252a55c41d7ed2BLOCKD61first audit
05

Questions

What is the QueryWeaver MCP server?

An open-source Text2SQL tool that transforms natural language into SQL using graph-powered schema understanding. Ask your database questions in plain English, QueryWeaver handles the weaving.

Is QueryWeaver safe to connect to an agent?

No — not without reading the findings first. The audit graded it D (61/100) and found 1 critical or high issue in the source. Each one is listed on this page with the file and line it is on.

What credentials does QueryWeaver need?

It reads ANTHROPIC_API_KEY, AZURE_API_KEY, COHERE_API_KEY, EMAIL_AUTH_ENABLED, FASTAPI_SECRET_KEY, GEMINI_API_KEY, GITHUB_CLIENT_SECRET, GOOGLE_CLIENT_SECRET, MAIL_PASSWORD, OAUTH_BASE_URL, OPENAI_API_KEY and TEST_USER2_PASSWORD from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.

How does QueryWeaver run?

It speaks streamable-http, so it runs as a service you connect to over the network. It is published on PyPI as queryweaver.

How current is this page?

The grade is for one exact copy of the source (2a55c41d7ed2), read on 2026-09-25. The repository is watched and re-audited when it changes.

Advertisement