pgEdge Postgres MCP

Установка

Работает в

• Claude Code
• Claude Desktop
• Cursor
• Windsurf
• GitHub Copilot
• VS Code
• SourceCraft
• Koda
• Coddy

Ручная установка

sudo apt-get install -y pgedge-postgres-mcp

Что делает

Postgres MCP от pgEdge — сервер на Go, который дает агенту SQL-запросы к базам PostgreSQL 14 и новее. Параметры подключения лежат в YAML-файле или в переменных `PGHOST`, `PGPORT`, `PGDATABASE`, `PGUSER` и `PGPASSWORD`. В файле можно описать несколько баз, и у каждой отдельно включается запись флагом `allow_writes`. По умолчанию каждый запрос выполняется в транзакции только на чтение. Встроенные инструменты: `query_database` выполняет SQL, `get_schema_info` показывает схему, `count_rows` считает строки таблицы с фильтром, `execute_explain` строит план запроса с реальным временем, `similarity_search` ищет по смыслу и по словам (BM25 и MMR), `generate_embedding` получает вектор текста у OpenAI, Voyage AI, Google Gemini или Ollama, а `search_knowledgebase` ищет по подключенной базе знаний. Каждый инструмент отключается в конфиге, и отключенный не попадает в список для модели. Есть ресурс `system_info` и четыре готовых сценария: исследование базы, настройка семантического поиска, разбор медленного запроса и проектирование схемы. Сервер работает по stdio для локального клиента или по HTTP с пользователями, токенами с истечением срока и входом через OAuth. Вместе с ним в репозитории идут чат-клиент на Go, который запускает сервер как дочерний процесс, и веб-интерфейс на React для вопросов к базе обычным языком.

Для кого. Для разработчиков, аналитиков и администраторов баз, которые работают с PostgreSQL из Claude Code, Cursor, Windsurf или VS Code с Copilot и хотят получить схему, запросы и планы EXPLAIN без ручного SQL. Подходит внутренним командам с доверенными пользователями.

Пример запроса к агенту

Покажи схему базы orders, посчитай заказы со статусом pending и разбери планом EXPLAIN запрос, который ищет их по email клиента

MCP

Транспорт

stdio, http

Авторизация

не нужна

Ограничения

• Автор предупреждает, что сервер дает модели чтение всей схемы и данных базы, и не рекомендует его для общедоступных приложений.
• Встроенные чат-клиент и веб-интерфейс требуют ключ Anthropic или OpenAI либо локальную Ollama. Для веб-интерфейса в конфиге включается раздел `llm`.
• Эмбеддинги и поиск по базе знаний выключены по умолчанию. Для них нужен провайдер: ключ OpenAI, Voyage AI или Gemini либо запущенная Ollama с моделью эмбеддингов.
• В режиме HTTP вход обязателен: пользователя создают флагом `-add-user` до запуска сервера. Установка из Docker Compose работает только в режиме HTTP и требует `PGEDGE_HTTP_ENABLED=true` в файле `.env`.
• Для stdio-клиентов нужен бинарник на диске или команда `docker run -i --rm`.
• Пакеты в репозиториях apt и dnf собраны для Debian, Ubuntu, RHEL, Rocky и Alma, на других системах сервер собирают из исходников на Go 1.21 или новее.
• Код распространяется по лицензии PostgreSQL.

Как отключить. Удалите запись pgedge из `.mcp.json` проекта или из настроек клиента и перезапустите агента. Для сервера по HTTP отзовите токены и пользователей: файлы с ними сервер перечитывает без перезапуска.

Коротко о README

Документация в папке docs разбита на разделы: быстрый старт для CLI, веб-интерфейса, Claude Code, Claude Desktop, Cursor, Windsurf и VS Code, развертывание в Docker и из исходников, справочник по инструментам, ресурсам и сценариям. Отдельно описаны аутентификация (пользователи, токены, OAuth), чек-лист безопасности, защита на уровне строк и столбцов, распределенное развертывание и свои определения инструментов. В репозитории есть тесты сервера, клиента и веб-части, схема OpenAPI, журнал изменений и данные для Cursor-плагина.