UniQuery

Stellen Sie Ihre Datenbankfragen in einfachem Englisch – von jedem MCP-Client oder über die Web-UI.

UniQuery verbindet sich im Nur-Lese-Modus mit einer Postgres- oder MongoDB-Datenbank und stellt sie als Agent für natürliche Sprachabfragen bereit. Es bietet zwei Zugänge zu derselben Engine: einen MCP-Server, der in Claude Desktop, Claude Code, Cursor oder jeden anderen MCP-Client integriert werden kann, und eine Next.js-Web-App zum Erkunden von Ergebnissen mit Diagrammen.

Der interessante Teil ist nicht der Schritt von natürlicher Sprache zu SQL – viele Tools können das. Es ist das, was darum herum passiert: PII-Maskierung, bevor Zeilen das Modell erreichen, harte Begrenzungen für Zeilenanzahl und Query-Timeouts, Durchsetzung des Nur-Lese-Modus am Connector und ein semantischer Schema-Speicher, damit der Agent mit der Zeit besser mit Ihrem Schema arbeitet.

Architektur

apps/
  web/                 Next.js 16 + React 19 + Recharts UI
packages/
  core/                The engine — connectors, agent loop, guardrails, viz
    connectors/        Postgres (Neon serverless / pg) and MongoDB, read-only
    agent/             Tool-calling loop over Vercel AI Gateway / Google Gemini
    guardrails/        PII masking + row/timeout clamps
    semantic/          Schema knowledge store with SQL migrations
    viz/               Result-shape classifier that picks a chart type
  mcp-server/          MCP server exposing core over @modelcontextprotocol/sdk

Related MCP server: Vela MCP Server

Schutzmechanismen

Das ist der Grund, warum dies mehr als eine Demo ist:

MCP-Server

Der MCP-Server registriert drei Tools:

• connectDatabase – registrieren Sie eine Postgres- oder MongoDB-Verbindung unter einer von Ihnen gewählten connectionId

• askQuestion – stellen Sie eine Frage in natürlicher Sprache an eine registrierte Verbindung; gibt eine Markdown-Tabelle plus eine vorgeschlagene Visualisierung zurück

• plus ein Tool zur Auflistung von Verbindungen, um zu sehen, was registriert ist

Ergebnisse werden als Markdown-Tabellen (auf 50 Zeilen für die Anzeige begrenzt) mit einem angehängten Diagrammvorschlag – bar, line, table oder none – zurückgegeben, der aus der Form des Ergebnisses abgeleitet wird und nicht vom Modell geraten wird.

Konfiguration in einem MCP-Client

{
  "mcpServers": {
    "uniquery": {
      "command": "node",
      "args": ["/path/to/uniquery/packages/mcp-server/dist/index.js"]
    }
  }
}

Dann, im Client:

Verbinden Sie sich mit meiner Postgres unter postgres://… als analytics, und sagen Sie mir dann, welche fünf Kunden im letzten Quartal den meisten Umsatz erzielt haben.

Erste Schritte

Erfordert Node.js >= 20 und pnpm 11.

pnpm install
pnpm build

# web app
pnpm dev

# MCP server
node packages/mcp-server/dist/index.js

Kopieren Sie .env.example in .env.local und füllen Sie Ihre Datenbank-URL und einen LLM-Schlüssel aus – entweder einen Vercel AI Gateway-Schlüssel (Standard) oder einen Google Gemini-Schlüssel mit provider: "google".

Technologie-Stack

TypeScript · pnpm workspaces · Model Context Protocol SDK · Vercel AI SDK 6 · Google Gemini · Neon serverless Postgres · MongoDB · Zod · Next.js 16 · Recharts · Vitest

Status

Funktionierender Prototyp. Die Engine, die Schutzmechanismen und der MCP-Server sind funktionsfähig; die Web-App deckt den Kernablauf von Abfrage und Diagramm ab.

Lizenz

MIT