DB Connect MCP — MCP-сервер для PostgreSQL, MySQL и ClickHouse
Даёт агенту доступ только на чтение к PostgreSQL, MySQL и ClickHouse: посмотреть схемы, таблицы, связи и профили колонок.
claude mcp add db-connect-mcp -e DATABASE_URL=<DATABASE_URL> -- uvx db-connect-mcpЧто делает DB Connect MCP
Сервер работает в режиме read-only. Разрешает только SELECT и WITH, сам добавляет лимиты к запросам, чтобы не вытащить всю таблицу. Каждое подключение открывается с параметрами только для чтения.
Внутри — адаптеры под три СУБД. Для PostgreSQL доступны метаданные и статистика, для MySQL и MariaDB — полная поддержка, для ClickHouse — аналитические нагрузки. Есть профилирование колонок (среднее, медиана, квартили, частота значений), сэмплирование данных, поиск объектов и планы запросов. Отдельно — гипотетические индексы в PostgreSQL через расширение HypoPG: это опт-ин, нужно DB_HYPOPG_ENABLED=true и администратор, установивший расширение. Оценки планировщика — не замеры реальной скорости.
Нужен Python 3.10 или выше и строка подключения в DATABASE_URL. Для баз за файрволом есть SSH-туннели с паролем или приватным ключом. Сервер лучше работает с базами, где у таблиц и колонок есть комментарии: тогда агенту понятнее модель данных. Без комментариев он видит только имена.
Какие задачи решает
- посмотреть структуру чужой базы, не подключаясь к ней вручную
- вытащить распределение значений по колонке
- найти таблицы и индексы по имени
- оценить план запроса до его запуска
- сравнить гипотетический индекс с текущим планом
Примеры запросов агенту
- Покажи все схемы в базе и список таблиц с размерами
- Опиши таблицу
ordersи её связи с другими таблицами - Профилируй колонку
statusв таблицеorders
Как установить DB Connect MCP
Командой платформы
claude mcp add db-connect-mcp -e DATABASE_URL=<DATABASE_URL> -- uvx db-connect-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from db-connect-mcp <команда>
Командой платформы
codex mcp add db-connect-mcp --env DATABASE_URL=<DATABASE_URL> -- uvx db-connect-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from db-connect-mcp <команда>
Файл настроек
{
"mcpServers": {
"db-connect-mcp": {
"command": "uvx",
"args": [
"db-connect-mcp"
],
"env": {
"DATABASE_URL": "<DATABASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from db-connect-mcp <команда>
Файл настроек
{
"servers": {
"db-connect-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"db-connect-mcp"
],
"env": {
"DATABASE_URL": "<DATABASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from db-connect-mcp <команда>
Командой платформы
gemini mcp add -e DATABASE_URL=<DATABASE_URL> db-connect-mcp uvx db-connect-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from db-connect-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о DB Connect MCP
Как установить DB Connect MCP в Claude Code?
Выполните claude mcp add db-connect-mcp -e DATABASE_URL=<DATABASE_URL> -- uvx db-connect-mcp, подставив свою строку подключения.
Что делает DB Connect MCP?
Даёт агенту доступ только на чтение к PostgreSQL, MySQL и ClickHouse: схемы, таблицы, колонки, связи, профилирование данных и планы запросов.
Какие базы поддерживаются?
PostgreSQL, MySQL и MariaDB, а также ClickHouse. Для каждого типа свой адаптер с проверками безопасности.
