dbt-docs-mcp

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