dbt-doctor MCP

Установка

Работает в

• Claude Desktop
• Cursor
• Claude Code
• SourceCraft
• Koda
• Coddy

Ручная установка

{
  "mcpServers": {
    "dbt-doctor": {
      "command": "dbt-doctor",
      "args": ["--project-dir", "/absolute/path/to/your/dbt/project"]
    }
  }
}

Что делает

dbt-doctor — MCP-сервер, который дает агенту контекст о проекте dbt. Он читает `manifest.json`, смотрит в хранилище данных и объясняет, где не хватает тестов и описаний. Оценка проекта от 0 до 100 процентов учитывает документацию, тесты и именование, а рейтинг моделей показывает, какие покрыты хуже всего. Профилирование считает доли NULL, кардинальность, минимум и максимум, число повторов одним пакетным SQL-запросом на таблицу. Из статистики выводятся предложения тестов `not_null`, `unique`, `accepted_values`. Сравнение хранилища с манифестом находит добавленные, удаленные и изменившие тип столбцы. Запись в `schema.yml` через `ruamel.yaml` сохраняет комментарии и ручные настройки, дописывая только недостающее, с предпросмотром различий. Инструментов двенадцать: `audit_project`, `profile_model`, `detect_schema_drift`, `suggest_tests`, `update_model_yaml` и другие.

Для кого. Аналитическим инженерам на dbt, которым нужно быстро увидеть дыры в тестах и описаниях и закрыть их через агента.

Пример запроса к агенту

Оцени здоровье проекта dbt, покажи пять моделей с худшим покрытием тестами и предложи тесты для самой слабой, не записывая их в файлы.

MCP

Транспорт

stdio

Авторизация

не нужна

Ограничения

Автор называет проект активной альфой и ведет перечень ограничений в `KNOWN_LIMITATIONS.md` и `STATUS.md`, а снимок статуса в README датирован концом 2025 года. До работы нужно выполнить `dbt compile`, чтобы появился `target/manifest.json`. Запросы к хранилищу идут только на чтение внутри транзакции, но профилирование все равно читает реальные таблицы. Запись в `schema.yml` показывает различия до применения, однако файлы под Git лучше сохранить до пробы.

Как отключить. Удалите запись `dbt-doctor` из конфигурации MCP-клиента и при желании выполните `pip uninstall dbt-doctor`.

Коротко о README

Сервер сводит аудит проекта, профилирование данных, дрейф схемы и безопасную запись документации в один набор инструментов.