dryrun — MCP-сервер для Claude Code: схема PostgreSQL без подключения
Отдаёт ИИ-агенту структуру вашей базы PostgreSQL из офлайн-снимка. Соединение с продакшеном и пароли не нужны.
claude mcp add dryrun -- npx -y @boringsql/dryrunЧто делает dryrun
dryrun состоит из двух частей. CLI подключается к PostgreSQL, вычитывает каталог — таблицы, индексы, ограничения, партиции, функции, политики RLS, триггеры — и складывает всё в снимок .dryrun/history.db. Дальше работа идёт офлайн: линтер проверяет соглашения об именовании и типы, ищет дубли индексов и циклические внешние ключи, а анализ миграций показывает, какие блокировки возьмёт DDL.
MCP-сервер читает тот же снимок и отдаёт агенту 9 инструментов через stdio или SSE: поиск по схеме, проверку запросов, разбор планов, проверку миграций, линтинг, состояние vacuum и топ запросов из pg_stat_statements. Если подключить живую базу, добавляются ещё три — explain_query, check_drift, columnar_report. Снимок коммитится в репозиторий: один человек с доступом к базе его снимает, остальные получают полную картину схемы без учётных данных.
Нужен PostgreSQL 14 или новее. На более старых серверах dryrun не откажется работать, но предупредит и часть данных не соберёт — статистику планировщика в частности. Ставится через Homebrew, npm или сборкой из исходников на Go 1.26+; готовые бинарники есть для macOS, Linux и Windows x64.
Какие задачи решает
- проверить, не возьмёт ли миграция блокировку на самой нагруженной таблице
- найти пропущенные индексы под внешние ключи
- сверить ссылки на колонки в SQL с реальной схемой
- отдать агенту структуру базы, не выдавая ему продакшен-доступ
- сравнить схему и статистику между двумя снимками
Примеры запросов агенту
- Проверь по снимку, безопасна ли эта миграция для PostgreSQL 16
- Прогони линтер по схеме и покажи, где нет первичного ключа
- Найди в схеме дублирующиеся индексы
Как установить dryrun
Командой платформы
claude mcp add dryrun -- npx -y @boringsql/dryrunКомандой платформы
codex mcp add dryrun -- npx -y @boringsql/dryrunФайл настроек
{
"mcpServers": {
"dryrun": {
"command": "npx",
"args": [
"-y",
"@boringsql/dryrun"
]
}
}
}Файл настроек
{
"servers": {
"dryrun": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@boringsql/dryrun"
]
}
}
}Командой платформы
gemini mcp add dryrun npx -y @boringsql/dryrunПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о dryrun
Как установить dryrun в Claude Code?
Одной командой: claude mcp add dryrun -- npx -y @boringsql/dryrun. Перед этим нужен Node, чтобы npx подтянул бинарник.
Что делает dryrun?
Снимает структуру PostgreSQL в файл и отдаёт её ИИ-агенту как набор инструментов: поиск по схеме, проверка запросов, анализ планов и миграций, линтинг.
Нужен ли доступ к базе, чтобы пользоваться MCP-сервером?
Нет. Сервер работает с готовым снимком. Подключение к живой базе требуется только для explain_query, check_drift и columnar_report.
