UniQuery

데이터베이스에 대해 평범한 영어로 질문하세요 — 모든 MCP 클라이언트 또는 웹 UI에서.

UniQuery는 읽기 전용 모드로 Postgres 또는 MongoDB 데이터베이스에 연결하여 자연어 쿼리 에이전트로 노출합니다. 동일한 엔진에 두 개의 전면 도어를 제공합니다: Claude Desktop, Claude Code, Cursor 또는 기타 MCP 클라이언트에 연결되는 MCP 서버와 차트로 결과를 탐색하기 위한 Next.js 웹 앱입니다.

흥미로운 부분은 자연어-대-SQL 단계가 아닙니다 — 많은 도구가 그렇게 합니다. 그 주변에 있는 것입니다: 행이 모델에 도달하기 전에 PII 마스킹, 행 수 및 쿼리 시간 초과에 대한 하드 클램프, 커넥터에서의 읽기 전용 강제, 그리고 에이전트가 시간이 지남에 따라 스키마를 더 잘 이해하도록 하는 의미론적 스키마 저장소입니다.

아키텍처

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

안전장치

이것이 데모 이상인 이유입니다:

MCP 서버

MCP 서버는 세 가지 도구를 등록합니다:

• connectDatabase — 선택한 connectionId 아래에 Postgres 또는 MongoDB 연결을 등록합니다

• askQuestion — 등록된 연결에 자연어 질문을 합니다; 마크다운 테이블과 제안된 시각화를 반환합니다

• 연결 목록 도구를 추가로 제공하여 등록된 것을 확인할 수 있습니다

결과는 마크다운 테이블(표시용으로 50행으로 제한)로 반환되며, 결과의 형태에서 파생된 차트 제안(bar, line, table, none)이 추가됩니다. 모델이 추측하는 것이 아닙니다.

MCP 클라이언트에서 구성

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

그런 다음 클라이언트에서:

postgres://…의 내 Postgres에 analytics로 연결한 다음, 지난 분기에 가장 많은 수익을 창출한 다섯 고객을 알려주세요.

시작하기

Node.js >= 20 및 pnpm 11이 필요합니다.

pnpm install
pnpm build

# web app
pnpm dev

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

.env.example을 .env.local로 복사하고 데이터베이스 URL과 LLM 키를 입력하세요 — Vercel AI Gateway 키(기본값) 또는 provider: "google"이 포함된 Google Gemini 키 중 하나입니다.

기술 스택

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

상태

작동하는 프로토타입입니다. 엔진, 안전장치, MCP 서버는 기능적이며, 웹 앱은 핵심 쿼리 및 차트 흐름을 다룹니다.

라이선스

MIT