postgres-mcp

postgres-mcp — MCP-сервер сообщества (автор — crystaldba). Разработка и эксплуатация Postgres: анализ производительности, настройка и проверки состояния. Ставится через pip или через Docker. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
crystaldba
Лицензия
MIT
Транспорт
stdio
Авторизация
api_key
ОС
Не указана
Языки
python

Уровень риска: high

В режиме unrestricted меняет данные и схему базы; строка подключения с паролем хранится в конфиге.

Настройка клиентов

cursor
{
    "code": "{\n    \"mcpServers\": {\n        \"postgres\": {\n            \"type\": \"sse\",\n            \"url\": \"http://localhost:8000/sse\"\n        }\n    }\n}",
    "file": "mcp.json",
    "lang": "json",
    "notes": "Дословно из README; сервер запущен в режиме SSE",
    "verified": "docs"
}

Что умеет

Postgres MCP Pro — открытый MCP-сервер для PostgreSQL от Crystal DBA. Он помогает ИИ-агенту на всех этапах работы с базой: от написания запросов и тестирования до настройки производительности в продакшене. Это не просто подключение к базе: сервер подбирает индексы, разбирает планы запросов и проверяет состояние базы.

Основное:

  • Состояние базы: здоровье индексов, использование подключений, буферный кэш, состояние vacuum, лимиты последовательностей, отставание репликации.
  • Подбор индексов: перебор тысяч возможных индексов под вашу нагрузку. Используется вариант алгоритма Anytime из советника по настройке Microsoft SQL Server.
  • Планы запросов: разбор EXPLAIN и оценка эффекта гипотетических индексов без их создания.
  • Понимание схемы: генерация SQL с учётом подробной структуры базы.
  • Безопасное выполнение SQL: настраиваемый доступ, режим только для чтения и разбор SQL перед выполнением.

Инструменты: list_schemas, list_objects, get_object_details, execute_sql, explain_query, get_top_queries (самые медленные запросы по данным pg_stat_statements), analyze_workload_indexes и analyze_query_indexes (рекомендации индексов, до 10 запросов за раз).

Кому подойдёт

  • Бэкенд-разработчикам: найти медленные запросы ORM и подобрать индексы прямо из редактора.
  • DBA и DevOps-инженерам: проверка состояния базы и разбор планов запросов.
  • Командам с продакшен-базами: работа в ограниченном режиме только для чтения.

Похожие серверы — в категории базы данных.

Установка

Нужен Docker или Python 3.12 и новее. Варианты: образ crystaldba/postgres-mcp, pipx install postgres-mcp или:

uv pip install postgres-mcp

Адрес базы передаётся в переменной DATABASE_URI. Режим доступа задаёт параметр --access-mode: unrestricted даёт полный доступ на чтение и запись к данным и схеме (для разработки), restricted ограничивает работу транзакциями только для чтения и лимитом времени выполнения (для продакшена).

Для подбора индексов и анализа производительности в базе нужны расширения pg_stat_statements и hypopg. В управляемых облачных базах они обычно уже доступны; на своём сервере pg_stat_statements должен быть указан в shared_preload_libraries. Тестирование сейчас ведётся на PostgreSQL 15, 16 и 17.

Подключение к клиентам

Конфиги приведены дословно из README. Для Claude Desktop показан запуск через uvx. Для Cursor и Windsurf — подключение к серверу в режиме SSE, который предварительно запускается, например, в Docker с параметром --transport=sse на порту 8000. Общий порядок — в инструкции как подключить MCP.

claude_desktop_config.json
{
  "mcpServers": {
    "postgres": {
      "command": "uvx",
      "args": [
        "postgres-mcp",
        "--access-mode=unrestricted"
      ],
      "env": {
        "DATABASE_URI": "postgresql://username:password@localhost:5432/dbname"
      }
    }
  }
}

Для продакшена замените --access-mode=unrestricted на --access-mode=restricted.

Проверка

Попросите агента перечислить схемы базы — сработает list_schemas. Затем запросите проверку состояния базы.

Примеры задач

Проверь состояние моей базы и скажи, есть ли проблемы с индексами и vacuum.
Найди самые медленные запросы и порекомендуй индексы для них.

Риски

В режиме unrestricted агент может менять данные и схему базы, в том числе удалять таблицы. Строка подключения с логином и паролем хранится в конфиге клиента. Режим SSE открывает порт 8000.

Как снизить риски: для рабочих баз используйте --access-mode=restricted и отдельного пользователя только с правами на чтение. Не открывайте порт SSE наружу. Лицензия — MIT.

Частые вопросы

Можно ли подключать сервер к продакшен-базе?

Да, в режиме restricted: он ограничивает работу транзакциями только для чтения и лимитом времени выполнения.

Какие версии PostgreSQL поддерживаются?

Авторы тестируют сервер на PostgreSQL 15, 16 и 17.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

dbx

Запросы агентов к базам данных через подключения, настроенные в DBX.

Риск: medium Лицензия: Apache-2.0 ★ 29 956

XERJ

Поиск для агентов с ответами и ссылками по локальному коду, документации и логам.

Риск: high Лицензия: Apache-2.0 ★ 18 558

MCP Toolbox for Databases

MCP Toolbox for Databases от Google подключает агента к вашим базам данных.

Риск: medium Лицензия: Apache-2.0 ★ 16 830

kubeshark

Наблюдение за сетевым трафиком Kubernetes и анализ API в реальном времени.

Риск: medium Лицензия: Apache-2.0 ★ 12 135

Источники