dbhawk — MCP-сервер для Claude Code: доступ к DBHawk
Даёт агенту доступ к данным DBHawk: список источников, схемы, таблицы, колонки и запросы под правами пользователя.
claude mcp add --env DBHAWK_BASE_URL=<DBHAWK_BASE_URL> --env DBHAWK_TOKEN=<DBHAWK_TOKEN> --env DBHAWK_DEFAULT_DATASOURCE=<DBHAWK_DEFAULT_DATASOURCE> --transport stdio dbhawk -- npx -y @dbhawk/mcpЧто делает dbhawk
dbhawk — тонкий мост к REST-поверхности DBHawk на /api/v2/mcp/**. Агент видит только те источники данных, которые назначены пользователю, а каждый запрос проходит классификацию и проверку по MCP-тиру групп. По умолчанию тир только на чтение, поэтому менять данные или схему получится лишь там, где тир это разрешает. Есть и работа с текстом: DBHawk AI переводит вопрос в SQL, оптимизирует и форматирует запросы.
Аутентификация настраивается двумя способами. Можно оставить DBHAWK_TOKEN пустым: при первом вызове инструмента откроется страница входа DBHawk (пароль, LDAP, 2FA или SSO), вы один раз подтверждаете доступ, и refresh-токен ложится в профиль пользователя — на Windows это %APPDATA%\dbhawk-mcp, на macOS ~/Library/Application Support/dbhawk-mcp, на Linux ~/.config/dbhawk-mcp. Для этого нужен DBHawk 7.0.1 с MCP-коннектором. Личный токен dbh_<id>.<secret> — не JWT: сервер сам обменивает его на короткоживущий JWT через POST /api/v2/auth/token/exchange, кэширует и обновляет до истечения срока, а при 401 повторяет запрос один раз. Владельцу токена нужен ACCESS_TO_DATA.
В репозитории лежит готовый бандл dist/dbhawk-mcp.mjs со всеми зависимостями внутри, поэтому git clone запускается без установки пакетов. В Claude поля вроде токена объявлены как userConfig, так что токен вводится замаскированным и хранится в системном хранилище, а не в settings.json.
Какие задачи решает
- посмотреть, какие источники данных назначены пользователю в DBHawk
- разобрать схему, таблицы и колонки перед написанием запроса
- выполнить запрос с учётом прав доступа и маскирования колонок
- получить SQL из вопроса на естественном языке через DBHawk AI
- проверить, хватает ли MCP-тира для правки данных
Примеры запросов агенту
- Покажи список источников данных, к которым у меня есть доступ в DBHawk
- Выведи таблицы и колонки схемы
publicв источникеsales - Переведи в SQL: сколько заказов было за последний месяц
Как установить dbhawk
Командой платформы
claude mcp add --env DBHAWK_BASE_URL=<DBHAWK_BASE_URL> --env DBHAWK_TOKEN=<DBHAWK_TOKEN> --env DBHAWK_DEFAULT_DATASOURCE=<DBHAWK_DEFAULT_DATASOURCE> --transport stdio dbhawk -- npx -y @dbhawk/mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add dbhawk --env DBHAWK_BASE_URL=<DBHAWK_BASE_URL> --env DBHAWK_TOKEN=<DBHAWK_TOKEN> --env DBHAWK_DEFAULT_DATASOURCE=<DBHAWK_DEFAULT_DATASOURCE> -- npx -y @dbhawk/mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"dbhawk": {
"command": "npx",
"args": [
"-y",
"@dbhawk/mcp"
],
"env": {
"DBHAWK_BASE_URL": "<DBHAWK_BASE_URL>",
"DBHAWK_TOKEN": "<DBHAWK_TOKEN>",
"DBHAWK_DEFAULT_DATASOURCE": "<DBHAWK_DEFAULT_DATASOURCE>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"dbhawk": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@dbhawk/mcp"
],
"env": {
"DBHAWK_BASE_URL": "<DBHAWK_BASE_URL>",
"DBHAWK_TOKEN": "<DBHAWK_TOKEN>",
"DBHAWK_DEFAULT_DATASOURCE": "<DBHAWK_DEFAULT_DATASOURCE>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e DBHAWK_BASE_URL=<DBHAWK_BASE_URL> -e DBHAWK_TOKEN=<DBHAWK_TOKEN> -e DBHAWK_DEFAULT_DATASOURCE=<DBHAWK_DEFAULT_DATASOURCE> dbhawk npx -y @dbhawk/mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о dbhawk
Как установить dbhawk в Claude Code?
Добавьте сервер командой claude mcp add dbhawk -e DBHAWK_BASE_URL=<DBHAWK_BASE_URL> -e DBHAWK_TOKEN=<DBHAWK_TOKEN> -- npx -y @dbhawk/mcp, затем проверьте инструменты через /mcp.
Что делает dbhawk?
Открывает ассистенту доступ к DBHawk: список источников, схемы, таблицы и колонки, запуск запросов под правами пользователя и текстовый ввод в SQL через DBHawk AI.
Нужен ли токен DBHawk для работы?
Нет. Если оставить DBHAWK_TOKEN пустым, сервер при первом вызове откроет вход в DBHawk в браузере и сохранит refresh-токен в профиле. Для этого нужен DBHawk 7.0.1 с MCP-коннектором.
