postgres-mcp

postgres-mcp

pgEdgePostgreSQL
174 звёзд15 форков
pgEdge Postgres MCP превращает PostgreSQL в базу данных, с которой можно разговаривать на естественном языке. Разработчикам и аналитикам не обязательно знать SQL — достаточно описать задачу словами. Сервер не просто переводит текст в SQL. Он использует гибридный поиск: объединяет семантическое понимание (pgvector) с классическим полнотекстовым поиском (BM25). Это даёт точные результаты даже при неточных формулировках. В сервер встроен веб-интерфейс для быстрой проверки запросов. pgEdge Postgres MCP создан для корпоративных проектов: есть система токенов, роли, шифрование и логирование.

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

Общее

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

Технологии

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

Описание

Возможности

  • Принимает запросы к PostgreSQL на русском или английском языке
  • Ищет по смыслу через pgvector и по тексту через BM25, объединяя результаты
  • Показывает веб-интерфейс для визуального взаимодействия с базой данных
  • Проверяет доступ по токенам и разграничивает права пользователей
  • Подключается к нескольким базам данных одновременно как единый агент
  • Настраивается через переменные окружения и JSON-конфигурацию
  • Шифрует ключи доступа с помощью Secret-файла
  • Работает в Docker, собирается из Go-исходников или запускается готовым бинарником
  • Совместим с Claude Desktop, Cursor и любыми MCP-клиентами
  • Подключает кастомные провайдеры эмбеддингов (OpenAI, HuggingFace)

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

Через Docker

docker pull pgedge/pgedge-postgres-mcp

Настройка для Claude Desktop

Добавьте в конфигурационный файл claude_desktop_config.json новый сервер:

{ "mcpServers": { "postgres": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "DATABASE_URL=postgresql://user:pass@host:5432/db", "-e", "PGEDGE_MCP_API_KEY=your_secret_key", "pgedge/pgedge-postgres-mcp" ] } } }

После добавления конфигурации перезапустите Claude Desktop.

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

  • «Покажи пять товаров с самой высокой маржинальностью в этом квартале»
  • «Найди в документации всё, что связано с установкой pgvector»
  • «Сравни объёмы продаж за этот месяц и за предыдущий»
  • «Выведи структуру таблицы orders и примеры данных из неё»

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

  • Язык реализации: Go
  • Транспорт: stdio (MCP), HTTP (веб-интерфейс)
  • Лицензия: PostgreSQL (аналог MIT/BSD)
  • Совместимые клиенты: Claude Desktop, Cursor, Go CLI, любые MCP-клиенты
  • Требования к базе: PostgreSQL 14+ с установленным расширением pgvector

Поделиться