dbt-docs-mcp

Сервер Model Context Protocol (MCP) для взаимодействия с метаданными проекта dbt, включая артефакты dbt Docs ( manifest.json , catalog.json ). Этот сервер предоставляет информацию о графе dbt и позволяет запрашивать сведения об узле, происхождение модели/столбца и связанные метаданные.

Ключевые функции

Этот сервер предоставляет инструменты для:

• Поиск узлов dbt:

  • Найти узлы (модели, источники, тесты и т. д.) по имени ( search_dbt_node_names ).

  • Найдите узлы на основе имен столбцов ( search_dbt_column_names ).

  • Поиск в скомпилированном SQL-коде узлов ( search_dbt_sql_code ).

• Осмотреть узлы:

  • Получить подробные атрибуты для любого заданного уникального идентификатора узла ( get_dbt_node_attributes ).

• Исследуйте родословную:

  • Найти прямые восходящие зависимости (предшественников) узла ( get_dbt_predecessors ).

  • Найти прямых нисходящих зависимых элементов (последователей) узла ( get_dbt_successors ).

• Родословная на уровне столбцов:

  • Отслеживание всех восходящих источников для определенного столбца в модели ( get_column_ancestors ).

  • Отслеживать все нисходящие зависимости определенного столбца в модели ( get_column_descendants ).

• Предлагаемые расширения:

  • Инструмент, позволяющий выполнять SQL-запросы.

  • Инструмент, который извлекает метаданные таблицы/представления/столбца непосредственно из базы данных.

  • Инструмент для поиска в базе знаний.

Начиная

1. Предварительные условия: Убедитесь, что у вас установлен Python и uv

2. Клонируйте репозиторий:

   git clone <repository-url> cd dbt-docs-mcp

3. Необязательно: проанализировать манифест dbt для определения происхождения на уровне столбцов:

   • Настройте необходимую среду Python, например: GXP2

   • Используйте предоставленный скрипт scripts/create_manifest_cl.py и просто укажите путь к вашему манифесту dbt, каталогу dbt и желаемые выходные пути для вашей схемы и файла происхождения столбцов: GXP3

   • В зависимости от размера вашего проекта dbt, создание столбцовой родословной может занять некоторое время (часы)

4. Запустите сервер:

   • Если ваш желаемый клиент MCP (рабочий стол Claude, Cursor и т. д.) поддерживает mcp.json, он будет выглядеть так: GXP4