PostgreSQL MCP Server

PostgreSQL MCP Server

neverinfamousMIT
8 звёзд2 форков
MCP-сервер для PostgreSQL. Разработчики и DevOps подключают к нему AI-ассистентов (Claude Desktop, другие MCP-клиенты). Сервер дает прямой доступ к базам данных: запросы, управление схемой, миграциями. Режим Code Mode выполняет операции в изолированных V8-воркерах — это безопасно для продуктивных данных. В арсенале 203 инструмента (до 278 в Code Mode), 24 ресурса и 21 AI-промпт. Сервер поддерживает популярные расширения вроде PostGIS, pgvector и pg_cron. Подходит для администрирования, аналитики и разработки.
DatabasesPostgres
Открыть на GitHub

Установка

npx -y @neverinfamous/postgres-mcp

Характеристики

Общее

  • СтатусСообщество
  • Разработчикneverinfamous
  • ЛицензияMIT

Технологии

  • Языки
    TypeScript
  • Транспорт
    stdio

Описание

Возможности

  • Управление объектами БД: создание и изменение таблиц, индексов, представлений, триггеров, функций.
  • Интроспекция схем: детальный обзор структуры таблиц, типов данных, ограничений, внешних ключей.
  • Миграции: создание, применение и откат изменений схемы. Отслеживание истории.
  • Умная фильтрация инструментов (Smart Tool Filtering): ассистент запрашивает только релевантные задаче инструменты. Экономит токены на сложных запросах.
  • Code Mode (изолированное исполнение): все команды к БД выполняются в true V8 isolate (worker_threads). Никакой код не имеет доступа к файловой системе или процессам хоста.
  • Connection pooling: встроенный пул соединений для эффективной работы под нагрузкой.
  • Аутентификация OAuth 2.1: защита HTTP/SSE-подключений.
  • Поддержка расширений PostgreSQL: PostGIS (геоданные), pgvector (векторный поиск), pg_cron (планировщик задач), citext (регистронезависимые строки), ltree (древовидные структуры), pgcrypto (шифрование), HypoPG (гипотетические индексы).
  • 21 готовый AI-промпт и 24 ресурса: ускоряют работу ассистента, не нужно объяснять базовые операции.
  • Детерминированная обработка ошибок: каждый запрос возвращает предсказуемый формат ответа.

Как подключить

  1. Убедитесь, что установлен Node.js 18 или новее.
  2. Запустите сервер через npx: npx -y @neverinfamous/postgres-mcp
  3. Отредактируйте конфигурацию вашего MCP-клиента. Для Claude Desktop это claude_desktop_config.json:{ "mcpServers": { "postgres": { "command": "npx", "args": ["-y", "@neverinfamous/postgres-mcp"], "env": { "DATABASE_URL": "postgresql://user:pass@host:5432/db" } } } }
  4. Перезапустите клиент.

Примеры запросов

  • «Покажи структуру таблицы users со всеми индексами и внешними ключами».
  • «Напиши запрос для поиска топ-10 клиентов по сумме заказов за последний квартал».
  • «Создай таблицу products с колонками id, name, price, category_id и внешним ключом на categories».
  • «Добавь GIST-индекс на колонку location таблицы stores для ускорения геопоиска».
  • «Покажи список всех миграций и их статус».

Технические детали

  • Язык: TypeScript, Node.js + V8 Isolates.
  • Транспорт: stdio (основной), HTTP/SSE.
  • Безопасность: изолированные воркеры, детерминированная обработка ошибок.
  • Лицензия: MIT.
  • Совместимость: Claude Desktop, все MCP-клиенты.

Поделиться