PGMCP соединяет AI-ассистентов с любой базой данных PostgreSQL через запросы на естественном языке. Задавайте вопросы на простом английском и получайте структурированные результаты SQL с автоматической трансляцией и надёжной обработкой ошибок.

Работает с: Cursor, Claude Desktop, расширениями VS Code и любыми совместимыми с MCP клиентом

Быстрый старт

PGMCP подключается к вашей существующей базе данных PostgreSQL и делает её доступной для AI-ассистентов через запросы на естественном языке.

Требования

• PostgreSQL база данных (существующая база данных с вашей схемой)
• Ключ OpenAI API (опционально, для генерации SQL на базе ИИ)

Основное использование

Вот как это работает:

Особенности

• С естественного языка в SQL: Задавайте вопросы на простом английском
• Автоматическое потоковое вещание: Автоматически обрабатывает большие наборы результатов
• Безопасный доступ только для чтения: предотвращает любые операции записи
• Поиск по тексту: Поиск по всем столбцам
• Несколько форматов выводов: таблица, JSON и CSV
• PostgreSQL Case Sensitivity: корректно обрабатывает имена смешанных падежей таблиц
• Универсальная совместимость: Работает с любой базой данных 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.               │