dbt-mcp
Официальный MCP-сервер dbt: интеграция dbt Core/Cloud CLI и метаданных проекта.
Что это
Официальный MCP-сервер dbt: интеграция dbt Core/Cloud CLI и метаданных проекта.
Как подключить
Вставьте блок в конфиг клиента (Claude Desktop, Claude Code, Cursor, VS Code, Cline). Для защищённого endpoint добавьте заголовок авторизации из официальной инструкции.
Что нового в версиях
dbt-mcp v2.8.0: новая архитектура контекста, единый реестр инструментов, исправление Flight SQL и новые зависимости.
- Ломает совместимостьВведена единая система контекстных мапперов вместо позиционного внедрения; удалено глобальное перечисление jobs, теперь требуется указание проекта или среды.
- НовоеFastMCP автоматически генерирует схемы и валидаторы, отклоняя лишние параметры, а Hosts проверяют права владения для job/run ID.
- НовоеПереименован параметр AdminApiConfig.environment_id, заменив prod_environment_id, а list_jobs теперь включает staging-окружения.
- ИсправленоОграничено время подготовки Flight SQL до 60 секунд, а при сбое соединения метрики собираются через GraphQL Semantic Layer.
- Новоеpydantic, pydantic-core, anyio и pyarrow объявлены прямыми зависимостями проекта.
dbt-mcp v2.7.0: добавлена пагинация для Admin, Discovery и Semantic Layer, улучшено управление памятью и исправлен импорт с pydantic 2.14.
- НовоеИнструменты Admin, Discovery и Semantic Layer теперь возвращают ограниченные страницы и метаданные для продолжения; вызывающие стороны должны следовать этим данным для получения дополнительных страниц
- НовоеДобавлена поддержка бюджетов ответов, внедренных хостом, наблюдений за допуском и размером потоковой передачи, а также ограничение состояния документации и выгрузка обработки артефактов.
- ИсправленоИсправлена ошибка ImportError при запуске с pydantic 2.14 путем удаления приватного импорта eval_type_backport из регистрации проксируемых инструментов.
- Обновлена зависимость source-map-js с версии 1.2.1 до 1.2.2 в интерфейсе /ui.
dbt-mcp v2.6.0: улучшена аутентификация OAuth, исправлена валидация токенов и обновлены зависимости безопасности.
- НовоеДобавлена инструкция по повторной аутентификации при истечении OAuth-сессии в ошибках запросов.
- НовоеОтносительные пути DBT_PROJECT_DIR и DBT_PROFILES_DIR теперь автоматически преобразуются в абсолютные при запуске.
- ИсправленоИсправлена валидация токенов dbt Platform OAuth: допущена погрешность до 10 секунд для корректной проверки iat.
- ИсправленоОбновлены библиотеки urllib3 (до 2.8.0) и PyJWT (до 2.15.0) для устранения уязвимостей безопасности.
- Оптимизирован процесс интеграционного тестирования в CI: упрощена логика одобрения изменений в PR.
Исправлено определение префикса аккаунта из DBT_HOST для предотвращения ошибок DNS и исправлен код ошибки 500 при валидации jq-фильтров.
- ИсправленоИсправлено определение префикса аккаунта из DBT_HOST, когда API dbt Platform возвращает null в поле subdomain, что предотвращало ошибки DNS в инструментах открытия и семантического слоя для многозонал
- ИсправленоИсправлена ошибка: метод get_job_run_artifacts возвращал ошибку сервера 500 вместо ошибки клиента 400 при невалидной проверке jq-фильтра.
В dbt-mcp v2.3.0 добавлен инструмент get_job_run_artifacts с фильтрацией jq, исправлено определение ошибок в Fusion и улучшена безопасность путей.
- НовоеВосстановлен инструмент get_job_run_artifacts с поддержкой фильтрации jq для работы с большими артефактами.
- НовоеДобавлена фильтрация артефактов dbt docs v2 (index/, metadata/) в list_job_run_artifacts и защита от некорректных путей в get_job_run_artifact.
- ИсправленоИсправлено определение ошибок и предупреждений source freshness в Fusion-запусках, где статусы имеют заглавные буквы.
- ИсправленоРеализована санитизация параметра artifact_path в get_job_run_artifacts для принятия только относительных путей.
Исправлено зависание event loop при форматировании метрик запросов; добавлена оценка объема аргументов и ответов в телеметрии.
- ИсправленоУстранено блокирование event loop (задержки свыше 25 секунд) при форматировании результатов query_metrics.
- НовоеВ события телеметрии добавлены оценки количества токенов и символов для аргументов вызовов инструментов и ответов.
В dbt-mcp v2.2.0 добавлен параметр dbt_version_override для запуска job на другой версии dbt без изменения окружения.
- НовоеВ функцию trigger_job_run добавлен необязательный параметр dbt_version_override, позволяющий запускать job на другой версии dbt без изменения самой задачи или её окружения.
Все релизы на GitHub → Пересказ на русском — по заметкам к релизам и коммитам.