DBHub — MCP-сервер для Claude Code: доступ к базам данных
Подключает ИИ-клиент к PostgreSQL, MySQL, SQL Server, Oracle и SQLite через один MCP-сервер. Пригодится, когда агенту нужно смотреть схему и выполнять запросы.
claude mcp add --env DSN=<DSN> --env DB_TYPE=<DB_TYPE> --env DB_HOST=<DB_HOST> --env DB_PORT=<DB_PORT> --env DB_USER=<DB_USER> --transport stdio dbhub -- npx -y @bytebase/dbhubЧто делает DBHub
DBHub — минималистичный MCP-сервер: по умолчанию он грузит всего два инструмента, execute_sql и search_objects, примерно на 1.4k токенов. Остальные — explain_sql и health_check — включаются отдельно. Контекстное окно остаётся свободным под работу, а не под описания инструментов.
Через один процесс можно держать несколько баз одновременно: PostgreSQL, MySQL, MariaDB, SQL Server, Oracle и SQLite. Список соединений задаётся в TOML-файле dbhub.toml, там же описываются свои параметризованные SQL-операции. Есть защита от разгулявшихся запросов: режим только для чтения, ограничение строк и таймаут. Для доступа к удалённой базе — SSH-туннель и SSL/TLS.
Запускается через npx @bytebase/dbhub@latest; для разработки самого сервера нужен Node.js >= 22.5.0, потому что используется встроенный модуль node:sqlite. Без корректного DSN сервер не поднимется, так что строку подключения готовьте заранее. Внутри есть веб-интерфейс Workbench — можно выполнять запросы и смотреть трейсы без MCP-клиента.
Какие задачи решает
- посмотреть схему таблиц перед правкой миграции
- выполнить SELECT и проверить данные прямо из чата
- свести несколько баз под одним MCP-сервером вместо отдельных процессов
- диагностировать прод в режиме только для чтения
- показать нетехническому коллеге заранее подготовленные вью
Примеры запросов агенту
- Покажи структуру таблицы
ordersв подключённой базе - Выполни запрос: сколько заказов создано за последние сутки
- Найди все индексы и процедуры, связанные с таблицей
users
Как установить DBHub
Командой платформы
claude mcp add --env DSN=<DSN> --env DB_TYPE=<DB_TYPE> --env DB_HOST=<DB_HOST> --env DB_PORT=<DB_PORT> --env DB_USER=<DB_USER> --transport stdio dbhub -- npx -y @bytebase/dbhubВместо <…> подставьте свои значения. Ещё 12 переменных окружения — в README сервера
Командой платформы
codex mcp add dbhub --env DSN=<DSN> --env DB_TYPE=<DB_TYPE> --env DB_HOST=<DB_HOST> --env DB_PORT=<DB_PORT> --env DB_USER=<DB_USER> -- npx -y @bytebase/dbhubВместо <…> подставьте свои значения. Ещё 12 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"dbhub": {
"command": "npx",
"args": [
"-y",
"@bytebase/dbhub"
],
"env": {
"DSN": "<DSN>",
"DB_TYPE": "<DB_TYPE>",
"DB_HOST": "<DB_HOST>",
"DB_PORT": "<DB_PORT>",
"DB_USER": "<DB_USER>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 12 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"dbhub": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@bytebase/dbhub"
],
"env": {
"DSN": "<DSN>",
"DB_TYPE": "<DB_TYPE>",
"DB_HOST": "<DB_HOST>",
"DB_PORT": "<DB_PORT>",
"DB_USER": "<DB_USER>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 12 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e DSN=<DSN> -e DB_TYPE=<DB_TYPE> -e DB_HOST=<DB_HOST> -e DB_PORT=<DB_PORT> -e DB_USER=<DB_USER> dbhub npx -y @bytebase/dbhubВместо <…> подставьте свои значения. Ещё 12 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о DBHub
Как установить DBHub в Claude Code?
Добавьте сервер командой `claude mcp add dbhub -e DSN=<DSN> -e DB_PASSWORD=<DB_PASSWORD> -e SSH_PASSWORD=<SSH_PASSWORD> -e SSH_PASSPHRASE=<SSH_PASSPHRASE> -- npx -y @bytebase/dbhub. Есть и второй вариант — с отдельными переменными DB_TYPE, DB_HOST, DB_PORT, DB_USER и транспортом stdio`.
Что делает DBHub?
Служит шлюзом между MCP-клиентом и базой данных. Агент получает инструменты для выполнения SQL и поиска по объектам схемы, а вы — ограничения вроде read-only и таймаута.
Какие базы поддерживает DBHub?
PostgreSQL, MySQL, MariaDB, SQL Server, Oracle и SQLite. Несколько соединений настраиваются в одном файле dbhub.toml.
