dbt-mcp

Официальный MCP-сервер dbt: интеграция dbt Core/Cloud CLI и метаданных проекта.

Dbt Labs Удалённый · HTTP Data Platforms official ★ 609

Что это

Официальный MCP-сервер dbt: интеграция dbt Core/Cloud CLI и метаданных проекта.

Как подключить

1Remote MCP — устанавливать локально не нужно
https://github.com/dbt-labs/dbt-mcp
2Добавить в конфиг MCP-клиента (mcp.json / claude_desktop_config.json)
{ "mcpServers": { "dbt-mcp": { "url": "https://github.com/dbt-labs/dbt-mcp" } } }

Вставьте блок в конфиг клиента (Claude Desktop, Claude Code, Cursor, VS Code, Cline). Для защищённого endpoint добавьте заголовок авторизации из официальной инструкции.

Что нового в версиях

v2.8.013 октября 2026 г.Ломает совместимость

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 объявлены прямыми зависимостями проекта.
v2.7.09 октября 2026 г.

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.
v2.6.06 октября 2026 г.

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.
v2.5.028 сентября 2026 г.
v2.3.111 сентября 2026 г.

Исправлено определение префикса аккаунта из DBT_HOST для предотвращения ошибок DNS и исправлен код ошибки 500 при валидации jq-фильтров.

  • ИсправленоИсправлено определение префикса аккаунта из DBT_HOST, когда API dbt Platform возвращает null в поле subdomain, что предотвращало ошибки DNS в инструментах открытия и семантического слоя для многозонал
  • ИсправленоИсправлена ошибка: метод get_job_run_artifacts возвращал ошибку сервера 500 вместо ошибки клиента 400 при невалидной проверке jq-фильтра.
v2.3.08 сентября 2026 г.

В 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 для принятия только относительных путей.
v2.2.13 сентября 2026 г.

Исправлено зависание event loop при форматировании метрик запросов; добавлена оценка объема аргументов и ответов в телеметрии.

  • ИсправленоУстранено блокирование event loop (задержки свыше 25 секунд) при форматировании результатов query_metrics.
  • НовоеВ события телеметрии добавлены оценки количества токенов и символов для аргументов вызовов инструментов и ответов.
v2.2.025 августа 2026 г.

В dbt-mcp v2.2.0 добавлен параметр dbt_version_override для запуска job на другой версии dbt без изменения окружения.

  • НовоеВ функцию trigger_job_run добавлен необязательный параметр dbt_version_override, позволяющий запускать job на другой версии dbt без изменения самой задачи или её окружения.

Все релизы на GitHub → Пересказ на русском — по заметкам к релизам и коммитам.