PGMCP는 자연어 쿼리를 통해 AI 어시스턴트를 모든 PostgreSQL 데이터베이스에 연결합니다. 쉬운 영어로 질문하면 자동 스트리밍과 강력한 오류 처리가 가능한 구조화된 SQL 결과를 얻을 수 있습니다.

**커서, Claude 데스크톱, VS Code 확장 프로그램, 그리고 모든 MCP 호환 클라이언트와 호환됩니다

퀵 스타트

PGMCP는 기존 PostgreSQL 데이터베이스와 연결되어 자연어 쿼리를 통해 AI 비서가 접근할 수 있도록 합니다.

전제 조건

• PostgreSQL 데이터베이스 (기존 데이터베이스에 스키마가 포함되어 있음)
• OpenAI API 키 (선택 사항, AI 기반 SQL 생성용)

기본 사용법

작동 방식은 다음과 같습니다:

특징

• 자연어에서 SQL로: 쉬운 영어로 질문하기
• 자동 스트리밍: 대규모 결과 세트를 자동으로 처리함
• 안전한 읽기 전용 접근: 쓰기 작업을 방지합니다
• 텍스트 검색: 모든 텍스트 열을 탐색합니다
• 다중 출력 형식: 테이블, JSON, CSV
• PostgreSQL 대문자 민감도: 혼합 대문자 테이블 이름을 올바르게 처리함
• 범용 호환성: 모든 PostgreSQL 데이터베이스와 호환됨

환경 변수

필수:

• DATABASE_URL: 기존 데이터베이스와 연결되는 PostgreSQL 연결 문자열

PGMCP - PostgreSQL Model Context Protocol Server

PGMCP connects AI assistants to any PostgreSQL database through natural language queries. Ask questions in plain English and get structured SQL results with automatic streaming and robust error handling.

Works with: Cursor, Claude Desktop, VS Code extensions, and any MCP-compatible client

Quick Start

PGMCP connects to your existing PostgreSQL database and makes it accessible to AI assistants through natural language queries.

Prerequisites

• PostgreSQL database (existing database with your schema)
• OpenAI API key (optional, for AI-powered SQL generation)

Basic Usage

# Set up environment variables
export DATABASE_URL="postgres://user:password@localhost:5432/your-existing-db"
export OPENAI_API_KEY="your-api-key"  # Optional

# Run server (using pre-compiled binary)
./pgmcp-server

# Test with client in another terminal
./pgmcp-client -ask "What tables do I have?" -format table
./pgmcp-client -ask "Who is the customer that has placed the most orders?" -format table
./pgmcp-client -search "john" -format table

Here is how it works:

👤 User / AI Assistant
         │
         │ "Who are the top customers?"
         ▼
┌─────────────────────────────────────────────────────────────┐
│                    Any MCP Client                           │
│                                                             │
│  PGMCP CLI  │  Cursor  │  Claude Desktop  │  VS Code  │ ... │
│  JSON/CSV   │  Chat    │  AI Assistant    │  Editor   │     │
└─────────────────────────────────────────────────────────────┘
         │
         │ Streamable HTTP / MCP Protocol
         ▼
┌─────────────────────────────────────────────────────────────┐
│                    PGMCP Server                             │
│                                                             │
│  🔒 Security    🧠 AI Engine      🌊 Streaming              │
│  • Input Valid  • Schema Cache    • Auto-Pagination         │
│  • Audit Log    • OpenAI API      • Memory Management       │
│  • SQL Guard    • Error Recovery  • Connection Pool         │
└─────────────────────────────────────────────────────────────┘
         │
         │ Read-Only SQL Queries
         ▼
┌─────────────────────────────────────────────────────────────┐
│                Your PostgreSQL Database                     │
│                                                             │
│  Any Schema: E-commerce, Analytics, CRM, etc.               │