dbmcp — MCP-сервер для Claude Code: базы данных
Подключает ИИ-агента к MySQL, MariaDB, PostgreSQL или SQLite. Помогает изучать схему и выполнять запросы из рабочего окружения.
claude mcp add --env HTTP_HOST=<HTTP_HOST> --env HTTP_PORT=<HTTP_PORT> --env HTTP_ALLOWED_ORIGINS=<HTTP_ALLOWED_ORIGINS> --env HTTP_ALLOWED_HOSTS=<HTTP_ALLOWED_HOSTS> --env HTTP_AUTH_TOKEN=<HTTP_AUTH_TOKEN> --transport stdio dbmcp -- docker run -i --rm -e HTTP_HOST -e HTTP_PORT -e HTTP_ALLOWED_ORIGINS -e HTTP_ALLOWED_HOSTS -e HTTP_AUTH_TOKEN ghcr.io/haymon-ai/dbmcp:0.15.1Что делает dbmcp
dbmcp даёт агенту инструменты для просмотра баз данных, таблиц, представлений и других объектов, а также для чтения запросов. Сервер поддерживает MySQL, MariaDB, PostgreSQL и SQLite; среди инструментов есть explainQuery и команды для работы со схемой. В режиме только для чтения средства записи и удаления скрыты.
Сервер работает через stdio или HTTP. Для доступа к MySQL, MariaDB или PostgreSQL через SSH можно настроить туннель. В Claude Code установка из команды ниже запускает Docker-образ, поэтому для этого способа нужен Docker. При публикации HTTP на внешнем интерфейсе требуется задать HTTP_AUTH_TOKEN.
Какие задачи решает
- посмотреть таблицы и объекты базы данных
- прочитать результат SQL-запроса
- объяснить план выполнения запроса
- ограничить доступ агента к операциям записи
Примеры запросов агенту
- Покажи таблицы и представления в подключённой базе данных.
- Выполни запрос чтения, который покажет последние записи.
- Объясни план выполнения этого запроса через
explainQuery.
Как установить dbmcp
Командой платформы
claude mcp add --env HTTP_HOST=<HTTP_HOST> --env HTTP_PORT=<HTTP_PORT> --env HTTP_ALLOWED_ORIGINS=<HTTP_ALLOWED_ORIGINS> --env HTTP_ALLOWED_HOSTS=<HTTP_ALLOWED_HOSTS> --env HTTP_AUTH_TOKEN=<HTTP_AUTH_TOKEN> --transport stdio dbmcp -- docker run -i --rm -e HTTP_HOST -e HTTP_PORT -e HTTP_ALLOWED_ORIGINS -e HTTP_ALLOWED_HOSTS -e HTTP_AUTH_TOKEN ghcr.io/haymon-ai/dbmcp:0.15.1Вместо <…> подставьте свои значения
Командой платформы
codex mcp add dbmcp --env HTTP_HOST=<HTTP_HOST> --env HTTP_PORT=<HTTP_PORT> --env HTTP_ALLOWED_ORIGINS=<HTTP_ALLOWED_ORIGINS> --env HTTP_ALLOWED_HOSTS=<HTTP_ALLOWED_HOSTS> --env HTTP_AUTH_TOKEN=<HTTP_AUTH_TOKEN> -- docker run -i --rm -e HTTP_HOST -e HTTP_PORT -e HTTP_ALLOWED_ORIGINS -e HTTP_ALLOWED_HOSTS -e HTTP_AUTH_TOKEN ghcr.io/haymon-ai/dbmcp:0.15.1Вместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"dbmcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"HTTP_HOST",
"-e",
"HTTP_PORT",
"-e",
"HTTP_ALLOWED_ORIGINS",
"-e",
"HTTP_ALLOWED_HOSTS",
"-e",
"HTTP_AUTH_TOKEN",
"ghcr.io/haymon-ai/dbmcp:0.15.1"
],
"env": {
"HTTP_HOST": "<HTTP_HOST>",
"HTTP_PORT": "<HTTP_PORT>",
"HTTP_ALLOWED_ORIGINS": "<HTTP_ALLOWED_ORIGINS>",
"HTTP_ALLOWED_HOSTS": "<HTTP_ALLOWED_HOSTS>",
"HTTP_AUTH_TOKEN": "<HTTP_AUTH_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"dbmcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"HTTP_HOST",
"-e",
"HTTP_PORT",
"-e",
"HTTP_ALLOWED_ORIGINS",
"-e",
"HTTP_ALLOWED_HOSTS",
"-e",
"HTTP_AUTH_TOKEN",
"ghcr.io/haymon-ai/dbmcp:0.15.1"
],
"env": {
"HTTP_HOST": "<HTTP_HOST>",
"HTTP_PORT": "<HTTP_PORT>",
"HTTP_ALLOWED_ORIGINS": "<HTTP_ALLOWED_ORIGINS>",
"HTTP_ALLOWED_HOSTS": "<HTTP_ALLOWED_HOSTS>",
"HTTP_AUTH_TOKEN": "<HTTP_AUTH_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e HTTP_HOST=<HTTP_HOST> -e HTTP_PORT=<HTTP_PORT> -e HTTP_ALLOWED_ORIGINS=<HTTP_ALLOWED_ORIGINS> -e HTTP_ALLOWED_HOSTS=<HTTP_ALLOWED_HOSTS> -e HTTP_AUTH_TOKEN=<HTTP_AUTH_TOKEN> dbmcp docker run -i --rm -e HTTP_HOST -e HTTP_PORT -e HTTP_ALLOWED_ORIGINS -e HTTP_ALLOWED_HOSTS -e HTTP_AUTH_TOKEN ghcr.io/haymon-ai/dbmcp:0.15.1Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о dbmcp
Как установить dbmcp в Claude Code?
Выполните `claude mcp add --env HTTP_HOST=<HTTP_HOST> --env HTTP_PORT=<HTTP_PORT> --env HTTP_ALLOWED_ORIGINS=<HTTP_ALLOWED_ORIGINS> --env HTTP_ALLOWED_HOSTS=<HTTP_ALLOWED_HOSTS> --env HTTP_AUTH_TOKEN=<HTTP_AUTH_TOKEN> --transport stdio dbmcp -- docker run -i --rm -e HTTP_HOST -e HTTP_PORT -e HTTP_ALLOWED_ORIGINS -e HTTP_ALLOWED_HOSTS -e HTTP_AUTH_TOKEN ghcr.io/haymon-ai/dbmcp:0.15.1`. Для этого способа нужен Docker.
Что делает dbmcp?
Подключает ИИ-агента к MySQL, MariaDB, PostgreSQL или SQLite через MCP. Агент может изучать структуру базы и выполнять запросы.
Как запретить dbmcp изменять базу?
В режиме только для чтения сервер скрывает инструменты записи, создания базы и удаления базы или таблиц.
