Перейти к основному содержимому

Запуск dbt MCP локально

Назад к гайдам
dbt MCP
ИИ
Быстрый старт
Начальный уровень
Menu

    Это краткое руководство поможет вам подключить сервер dbt MCP к локальному проекту dbt. Такая настройка позволит вашему ИИ-ассистенту использовать инструменты команд dbt (run, build, test, compile и другие).

    Если вы хотите подключиться к dbt platform с помощью CLI, см. краткое руководство по OAuth.

    Чтобы подключиться к dbt Wizard, см. обзор dbt Wizard.

    Клонировать репозиторий не нужно

    Вам не нужно клонировать репозиторий dbt-mcp. Установите uv и выполните uvx dbt-mcp — эта команда загрузит и запустит dbt-mcp.

    Предварительные требования​

    • Установите uv
    • Локальный проект dbt (папка, содержащая файл dbt_project.yml)
    • Установленный и доступный локально dbt

    Полный список переменных окружения и инструкции по включению и отключению наборов инструментов см. в справочнике переменных окружения.

    Шаг 1. Определите пути​

    Перед настройкой MCP-клиента вам понадобятся два значения:

    • DBT_PROJECT_DIR — полный путь к папке вашего проекта dbt (где находится dbt_project.yml). Например, если ваш проект называется jaffle_shop, путь должен быть /Users/yourname/dbt-projects/jaffle_shop.
    • DBT_PATH — полный путь к исполняемому файлу dbt.
    # Find DBT_PATH
    which dbt
    # Example output: /opt/homebrew/bin/dbt

    # Find DBT_PROJECT_DIR — run from inside your project folder
    pwd
    # Example output: /Users/yourname/projects/my_dbt_project

    Шаг 2. Добавьте сервер в MCP-клиент​

    Замените пути ниже значениями из шага 1:

    1. В Claude Desktop перейдите в Settings → вкладка Developer → Edit Config.
    2. Вставьте следующую конфигурацию, заменив пути фактическими значениями:
    {
      "mcpServers": {
        "dbt": {
          "command": "uvx",
          "args": ["dbt-mcp"],
          "env": {
            "DBT_PROJECT_DIR": "/path/to/your/dbt/project",
            "DBT_PATH": "/path/to/your/dbt/executable"
          }
        }
      }
    }
    1. Сохраните изменения и перезапустите Claude Desktop.

    Расположение файла конфигурации:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json

    Шаг 3. Проверьте настройку​

    Попросите ИИ-ассистента выполнить команду dbt (например, «Выполни dbt compile для моего проекта» или «Выведи список всех моделей в моём проекте»). Если dbt MCP работает, ассистент выполнит команду для вашего локального проекта.

     Необязательно: проверка из командной строки
    uvx dbt-mcp

    Если ошибок нет, конфигурация верна. Нажмите Ctrl+C, чтобы остановить сервер.

    Доступные возможности​

    При настройке только через CLI ваш ИИ-ассистент может использовать:

    • dbt run, dbt build, dbt test, dbt compile, dbt list, dbt parse, dbt show
    • Информацию о происхождении и зависимостях моделей и сведения об узлах вашего локального проекта
    • Инструменты Codegen (если включены — см. справочник переменных окружения)

    Для таких возможностей платформы, как Semantic Layer, Discovery API и запросы к метаданным, требуется учётная запись dbt platform. Чтобы добавить их, см. Подключение к dbt platform.

    Устранение неполадок​

    Не удаётся найти исполняемый файл uvx
    Сервер не запускается

    Все темы по устранению неполадок см. в разделе Часто задаваемые вопросы о dbt MCP и устранение неполадок.

    Дальнейшие шаги​

    Нашли ошибку?

    0