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 меняет данные и схему базы; строка подключения с паролем хранится в конфиге.
Настройка клиентов
{
"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.
{
"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.
XERJ
Поиск для агентов с ответами и ссылками по локальному коду, документации и логам.
MCP Toolbox for Databases
MCP Toolbox for Databases от Google подключает агента к вашим базам данных.
kubeshark
Наблюдение за сетевым трафиком Kubernetes и анализ API в реальном времени.