DB Explorer — MCP-сервер для Claude Code: SQL и установка
MCP-сервер даёт агенту доступ к схеме и безопасным SQL-запросам без записи в PostgreSQL, MySQL или SQLite.
claude mcp add db-explorer-mcp-server -e DATABASE_URL=<DATABASE_URL> -- uvx db-explorer-mcp-serverЧто делает DB Explorer
DB Explorer подключает MCP-клиент к реляционной базе и помогает изучать схему, выполнять безопасные SELECT-запросы, смотреть планы через EXPLAIN и получать советы по индексам. В сервере есть инструменты explore_schema, execute_query, explain_query, validate_schema, suggest_index, migration_context и validate_migration.
SQL от модели проходит разбор перед отправкой в базу: сервер принимает один запрос только для чтения, отклоняет запись и применяет ограничение на число строк. Проверка миграций разбирает операции up/down, но не выполняет их. Поддерживаются локальный stdio и удалённый HTTP с bearer-токеном.
Для запуска нужны Python 3.11+ и uv. Подключение задаётся через DATABASE_URL; сервер работает с PostgreSQL, MySQL и SQLite через SQLAlchemy. Без Python 3.11+ и uv сервер не запустится.
Какие задачи решает
- изучить схему реляционной базы
- выполнить безопасный SELECT-запрос
- проверить план выполнения SQL
- найти подходящие индексы
- проверить миграцию без запуска
Примеры запросов агенту
- Покажи схему базы данных и перечисли таблицы с их связями.
- Выполни безопасный SELECT для поиска заказов за нужный период.
- Проверь план этого запроса и предложи индекс, если он нужен.
Как установить DB Explorer
Командой платформы
claude mcp add db-explorer-mcp-server -e DATABASE_URL=<DATABASE_URL> -- uvx db-explorer-mcp-serverВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from db-explorer-mcp-server <команда>
Командой платформы
codex mcp add db-explorer --env DATABASE_URL=<DATABASE_URL> -- uvx db-explorer-mcp-serverВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from db-explorer-mcp-server <команда>
Файл настроек
{
"mcpServers": {
"db-explorer": {
"command": "uvx",
"args": [
"db-explorer-mcp-server"
],
"env": {
"DATABASE_URL": "<DATABASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from db-explorer-mcp-server <команда>
Файл настроек
{
"servers": {
"db-explorer": {
"type": "stdio",
"command": "uvx",
"args": [
"db-explorer-mcp-server"
],
"env": {
"DATABASE_URL": "<DATABASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from db-explorer-mcp-server <команда>
Командой платформы
gemini mcp add -e DATABASE_URL=<DATABASE_URL> db-explorer uvx db-explorer-mcp-serverВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from db-explorer-mcp-server <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о DB Explorer
Как установить DB Explorer в Claude Code?
Выполните claude mcp add db-explorer-mcp-server -e DATABASE_URL=<DATABASE_URL> -- uvx db-explorer-mcp-server. Затем подключите сервер в Claude Code.
Что делает DB Explorer?
Он позволяет агенту читать схему, запускать безопасные SELECT-запросы, анализировать планы, проверять состояние схемы и разбирать миграции. Операции записи сервер отклоняет.
Какие базы данных поддерживает DB Explorer?
PostgreSQL, MySQL и SQLite. Подключение передаётся через DATABASE_URL.
