DBeast PostgreSQL MCP — MCP-сервер для Claude Code: что делает
Подключает ИИ-ассистента к PostgreSQL: разбор схемы, безопасные запросы, аудит безопасности и производительности.
claude mcp add --env DATABASE_URL=<DATABASE_URL> --env DB_HOST=<DB_HOST> --env DB_PORT=<DB_PORT> --env DB_USER=<DB_USER> --env DB_PASSWORD=<DB_PASSWORD> --transport stdio dbeast-postgresql-mcp -- docker run -i --rm -e DATABASE_URL -e DB_HOST -e DB_PORT -e DB_USER -e DB_PASSWORD ghcr.io/snss10/dbeast:2.0.2Что делает DBeast PostgreSQL MCP
DBeast работает как локальный stdio MCP-сервер на Python. Ассистент запускает его отдельным процессом, а доступ к базе передаётся через переменные окружения — DATABASE_URL, DB_HOST, DB_PORT, DB_USER, DB_PASSWORD. HTTP-сервис поднимать не нужно, ничего лишнего в инфраструктуре не появляется.
Вместо одного универсального execute_sql сервер отдаёт 21 инструмент по десяти категориям: get_schema и dependency_analysis для разбора структуры, execute_query для чтения, analyze_query и query_optimizer для планов и индексов, analyze_impact для предпросмотра записи, security_audit и sensitive_data_scan, maintenance_analysis, data_quality_report, replication_status. Чтение ограничено автоматическим лимитом строк.
Нужен Python 3.11+ и PostgreSQL 12+. Установка описана двумя путями: из исходников через pip install -e . или через Docker-образ ghcr.io/snss10/dbeast:2.0.2. Второй вариант удобнее для Claude, Codex и Gemini CLI — команды claude mcp add, codex mcp add и gemini mcp add подставляют переменные окружения сами. Для Cursor, GitHub Copilot и Windsurf конфигурация прописывается вручную в JSON. Без переменных с учётными данными базы сервер не подключится.
Какие задачи решает
- разобрать схему незнакомой базы перед правками
- посмотреть план запроса и понять, почему он тормозит
- оценить, сколько строк затронет массовое обновление, до его запуска
- проверить роли, привилегии и открытые таблицы в public
- найти дубликаты и пропуски в ключевых колонках
Примеры запросов агенту
- Покажи схему таблицы
ordersсо связями и индексами - Разбери план запроса дашборда и предложи индексы
- Проверь public на проблемы безопасности и устаревшие данные
Как установить DBeast PostgreSQL MCP
Командой платформы
claude mcp add --env DATABASE_URL=<DATABASE_URL> --env DB_HOST=<DB_HOST> --env DB_PORT=<DB_PORT> --env DB_USER=<DB_USER> --env DB_PASSWORD=<DB_PASSWORD> --transport stdio dbeast-postgresql-mcp -- docker run -i --rm -e DATABASE_URL -e DB_HOST -e DB_PORT -e DB_USER -e DB_PASSWORD ghcr.io/snss10/dbeast:2.0.2Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера
Командой платформы
codex mcp add dbeast-postgresql-mcp --env DATABASE_URL=<DATABASE_URL> --env DB_HOST=<DB_HOST> --env DB_PORT=<DB_PORT> --env DB_USER=<DB_USER> --env DB_PASSWORD=<DB_PASSWORD> -- docker run -i --rm -e DATABASE_URL -e DB_HOST -e DB_PORT -e DB_USER -e DB_PASSWORD ghcr.io/snss10/dbeast:2.0.2Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера
Файл настроек
{
"mcpServers": {
"dbeast-postgresql-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"DATABASE_URL",
"-e",
"DB_HOST",
"-e",
"DB_PORT",
"-e",
"DB_USER",
"-e",
"DB_PASSWORD",
"ghcr.io/snss10/dbeast:2.0.2"
],
"env": {
"DATABASE_URL": "<DATABASE_URL>",
"DB_HOST": "<DB_HOST>",
"DB_PORT": "<DB_PORT>",
"DB_USER": "<DB_USER>",
"DB_PASSWORD": "<DB_PASSWORD>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера
Файл настроек
{
"servers": {
"dbeast-postgresql-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"DATABASE_URL",
"-e",
"DB_HOST",
"-e",
"DB_PORT",
"-e",
"DB_USER",
"-e",
"DB_PASSWORD",
"ghcr.io/snss10/dbeast:2.0.2"
],
"env": {
"DATABASE_URL": "<DATABASE_URL>",
"DB_HOST": "<DB_HOST>",
"DB_PORT": "<DB_PORT>",
"DB_USER": "<DB_USER>",
"DB_PASSWORD": "<DB_PASSWORD>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера
Командой платформы
gemini mcp add -e DATABASE_URL=<DATABASE_URL> -e DB_HOST=<DB_HOST> -e DB_PORT=<DB_PORT> -e DB_USER=<DB_USER> -e DB_PASSWORD=<DB_PASSWORD> dbeast-postgresql-mcp docker run -i --rm -e DATABASE_URL -e DB_HOST -e DB_PORT -e DB_USER -e DB_PASSWORD ghcr.io/snss10/dbeast:2.0.2Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о DBeast PostgreSQL MCP
Как установить DBeast PostgreSQL MCP в Claude Code?
Одной командой: `claude mcp add --env DATABASE_URL=<DATABASE_URL> --env DB_HOST=<DB_HOST> --env DB_PORT=<DB_PORT> --env DB_USER=<DB_USER> --env DB_PASSWORD=<DB_PASSWORD> --transport stdio dbeast-postgresql-mcp -- docker run -i --rm -e DATABASE_URL -e DB_HOST -e DB_PORT -e DB_USER -e DB_PASSWORD ghcr.io/snss10/dbeast:2.0.2`. Docker должен быть установлен и запущен.
Что делает DBeast PostgreSQL MCP?
Даёт ассистенту набор инструментов для работы с PostgreSQL: просмотр схемы, чтение данных, анализ запросов и планов, проверка безопасности и обслуживания, отчёты о качестве данных.
Можно ли выполнять через него произвольный SQL?
Запись напрямую не проходит: execute_query работает только с SELECT и сам ограничивает число строк. Для изменений есть analyze_impact — он показывает затронутые строки и риск, но ничего не выполняет.
