metabase-ai-assistant — MCP-сервер для Claude Code: Metabase и dbt
MCP-сервер, который подключает ИИ-ассистента к вашей Metabase: SQL, дашборды, dbt-модели и маскировка персональных данных.
claude mcp add --env METABASE_URL=<METABASE_URL> --env METABASE_USERNAME=<METABASE_USERNAME> --env METABASE_PASSWORD=<METABASE_PASSWORD> --env METABASE_API_KEY=<METABASE_API_KEY> --env DATABASE_HOST=<DATABASE_HOST> --transport stdio metabase-ai-assistant -- npx -y metabase-ai-assistantЧто делает metabase-ai-assistant
Сервер даёт ассистенту доступ к Metabase Business Intelligence. Через него можно генерировать SQL, собирать дашборды, читать dbt-манифесты и семантические модели, а также выполнять запросы с автоматическим исправлением ошибок: движок ловит опечатки в именах колонок, пропущенный GROUP BY и различия диалектов Postgres, MySQL, BigQuery, Snowflake и SQLite.
Внутри — инструменты для работы с dbt: сканирование проекта, поиск кратчайших путей соединения таблиц, советник по предагрегациям с DDL для Postgres, BigQuery, Snowflake, ClickHouse, DuckDB, Redshift и MySQL. Есть отдельный слой управления бизнес-правилами: правило сначала предлагается в статусе PENDING_APPROVAL, активируется только после подтверждения и архивируется с обязательной причиной. Персональные данные в результатах запросов маскируются на лету.
Для запуска нужны Node.js 18+ и доступ к вашей Metabase. В конфигурацию передаются METABASE_URL, METABASE_USERNAME, METABASE_PASSWORD, METABASE_API_KEY и DATABASE_HOST — без них сервер не подключится к инстансу. Совместимость заявлена с Metabase v0.43 и выше, включая Open Source и Enterprise.
Какие задачи решает
- сгенерировать SQL-запрос к Metabase по описанию на естественном языке
- собрать дашборд из dbt-моделей и YAML-разметки
- найти путь соединения между таблицами в dbt-проекте
- предложить предагрегации и DDL для материализованных представлений
- замаскировать персональные данные в результатах запросов
Примеры запросов агенту
- Покажи список моделей в dbt-проекте и приоритетные источники для запроса по выручке
- Собери дашборд в Metabase из
schema.ymlс метаданными Lightdash - Выполни запрос к Metabase и исправь ошибки, если он не пройдёт
Как установить metabase-ai-assistant
Командой платформы
claude mcp add --env METABASE_URL=<METABASE_URL> --env METABASE_USERNAME=<METABASE_USERNAME> --env METABASE_PASSWORD=<METABASE_PASSWORD> --env METABASE_API_KEY=<METABASE_API_KEY> --env DATABASE_HOST=<DATABASE_HOST> --transport stdio metabase-ai-assistant -- npx -y metabase-ai-assistantВместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
Командой платформы
codex mcp add metabase-ai-assistant --env METABASE_URL=<METABASE_URL> --env METABASE_USERNAME=<METABASE_USERNAME> --env METABASE_PASSWORD=<METABASE_PASSWORD> --env METABASE_API_KEY=<METABASE_API_KEY> --env DATABASE_HOST=<DATABASE_HOST> -- npx -y metabase-ai-assistantВместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
Файл настроек
{
"mcpServers": {
"metabase-ai-assistant": {
"command": "npx",
"args": [
"-y",
"metabase-ai-assistant"
],
"env": {
"METABASE_URL": "<METABASE_URL>",
"METABASE_USERNAME": "<METABASE_USERNAME>",
"METABASE_PASSWORD": "<METABASE_PASSWORD>",
"METABASE_API_KEY": "<METABASE_API_KEY>",
"DATABASE_HOST": "<DATABASE_HOST>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
Файл настроек
{
"servers": {
"metabase-ai-assistant": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"metabase-ai-assistant"
],
"env": {
"METABASE_URL": "<METABASE_URL>",
"METABASE_USERNAME": "<METABASE_USERNAME>",
"METABASE_PASSWORD": "<METABASE_PASSWORD>",
"METABASE_API_KEY": "<METABASE_API_KEY>",
"DATABASE_HOST": "<DATABASE_HOST>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
Командой платформы
gemini mcp add -e METABASE_URL=<METABASE_URL> -e METABASE_USERNAME=<METABASE_USERNAME> -e METABASE_PASSWORD=<METABASE_PASSWORD> -e METABASE_API_KEY=<METABASE_API_KEY> -e DATABASE_HOST=<DATABASE_HOST> metabase-ai-assistant npx -y metabase-ai-assistantВместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о metabase-ai-assistant
Как установить metabase-ai-assistant в Claude Code?
Выполните `claude mcp add metabase-ai-assistant -e METABASE_URL=<METABASE_URL> -e METABASE_PASSWORD=<METABASE_PASSWORD> -e METABASE_API_KEY=<METABASE_API_KEY> -e DATABASE_PASSWORD=<DATABASE_PASSWORD> -- npx -y metabase-ai-assistant`. Подставьте свои значения вместо плейсхолдеров.
Что делает metabase-ai-assistant?
Подключает ИИ-ассистента к Metabase: генерация SQL, сборка дашбордов, работа с dbt-моделями и семантическими правилами, маскировка персональных данных в результатах.
Какие версии Metabase поддерживаются?
Заявлена совместимость с Metabase v0.43 и выше, включая Open Source и Enterprise. Для новых версий поддерживается формат MBQL 5.
