Skip to main content
Glama
uniquery

uniquery

by yashdhingra0

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: Company Data MCP Server

안전장치

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

안전장치

동작

읽기 전용 액세스

커넥터는 모델이 생성하는 것과 관계없이 쓰기를 실행하지 않습니다

PII 마스킹

email, ssn, phone, dob, credit_card, cvv, passport, api_key, password 등과 일치하는 열은 에이전트 도구 내부에서 삭제됩니다 — 마스킹된 값은 LLM 컨텍스트에 도달하지 않습니다. 추가 열은 수동으로 태그할 수 있습니다

행 수 제한 클램프

모든 요청은 에이전트나 MCP 클라이언트가 요청하는 것과 관계없이 [1, 1000] 행으로 제한됩니다

시간 초과 클램프

모든 쿼리는 [1s, 30s]로 제한됩니다

Zod 검증 도구

MCP 도구 입력은 커넥터에 도달하기 전에 스키마 검사를 받습니다

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      D
      maintenance
      Enables read-only exploration and querying of PostgreSQL or MySQL databases via MCP, with schema discovery, safe SQL validation, natural language to SQL conversion, and CSV export.
      11
      2
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables read-only access to company data across PostgreSQL, MongoDB Atlas, and flat files through MCP tools, allowing AI assistants to query and retrieve information via natural language.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that enables natural-language SQL queries across multiple databases (ClickHouse, Teradata, PostgreSQL, MySQL, SQL Server, DB2, Oracle, MongoDB) with dialect-correct SQL generation, PII masking, and security-by-construction controls.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Provides read-only, guarded access to business databases via MCP. Enables natural language querying with built-in security barriers like table allowlists, PII masking, and audit logging.
      MIT