Skip to main content
Glama
Sign In
enesjakozh

dbt-mcp

Official
by dbt-labs
GitHub
Python
Apache 2.0
165
  • Linux
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Provides tools to interact with dbt, including executing dbt CLI commands (build, compile, run, test), accessing Semantic Layer for metric querying, and using Discovery API to explore models and their relationships in a dbt project.

dbt MCP 서버

이 MCP(Model Context Protocol) 서버는 DBT와 상호 작용하는 도구를 제공합니다. 자세한 내용은 이 블로그를 참조하세요.

건축학

설정

  1. 저장소를 복제합니다.

지엑스피1

  1. uv 설치
  2. 설치 작업
  3. task install 실행
  4. 환경 변수 구성:
cp .env.example .env

그런 다음 특정 환경 변수로 .env 편집합니다( README.md 의 Configuration 섹션 참조).

구성

MCP 서버는 다음과 같은 구성을 취합니다.

도구 그룹

이름기본설명
DISABLE_DBT_CLIfalsedbt Core 및 dbt Cloud CLI MCP 도구를 비활성화하려면 이를 true 로 설정하세요.
DISABLE_SEMANTIC_LAYERfalsedbt Semantic Layer MCP 객체를 비활성화하려면 이것을 true 로 설정하세요.
DISABLE_DISCOVERYfalsedbt Discovery API MCP 객체를 비활성화하려면 이것을 true 로 설정하세요.
DISABLE_REMOTEtrue원격 MCP 객체를 활성화하려면 이것을 false 로 설정하세요.

검색 및 의미 계층 구성

이름기본설명
DBT_HOSTcloud.getdbt.comDBT 클라우드 인스턴스 호스트 이름입니다. 이 이름은 여기에서 찾을 수 있는 Access URL 유사합니다. 다중 셀을 사용하는 경우 ACCOUNT_PREFIX 여기에 포함하지 마세요.
MULTICELL_ACCOUNT_PREFIX-다중 셀을 사용하는 경우 이 환경 변수를 ACCOUNT_PREFIX 로 설정하세요. 다중 셀을 사용하지 않는 경우 이 환경 변수를 설정하지 마세요. 자세한 내용은 여기에서 확인하세요.
DBT_TOKEN-개인 액세스 토큰 또는 서비스 토큰입니다. 참고: Semantic Layer를 사용할 때는 서비스 토큰이 필요합니다.
DBT_PROD_ENV_ID-귀하의 dbt Cloud 프로덕션 환경 ID

원격 도구 구성

이름설명
DBT_DEV_ENV_ID귀하의 dbt Cloud 개발 환경 ID
DBT_USER_ID귀하의 dbt Cloud 사용자 ID

dbt CLI 구성

이름설명
DBT_PROJECT_DIRdbt 프로젝트로 가는 길
DBT_PATHdbt Core 또는 dbt Cloud CLI 실행 파일의 경로입니다. which dbt 실행하여 dbt 실행 파일을 찾을 수 있습니다.

MCP 클라이언트와 함께 사용

설치 가 끝나면 MCP 클라이언트와 함께 서버를 사용할 수 있습니다.

이 구성은 해당 클라이언트의 설정 파일에 추가됩니다. <> 안의 섹션을 다음과 같이 바꿔주세요.

{ "mcpServers": { "dbt-mcp": { "command": "<path-to-mcp-executable>", "args": [ "run", "<path-to-this-directory>/src/dbt_mcp/main.py" ] } } }

<path-to-mcp-executable> OS에 따라 달라집니다.

  • Linux 및 Mac: <path-to-this-directory>/.venv/bin/mcp
  • PC: <path-to-this-directory>/.venv/Scripts/mcp

클로드 데스크탑

다음 지침에 따라 claude_desktop_config.json 파일을 만들고 연결하세요.

Mac에서는 Claude Desktop 로그를 ~/Library/Logs/Claude 에서 찾을 수 있습니다.

커서

  1. 커서 메뉴를 열고 설정 → 커서 설정 → MCP를 선택하세요.
  2. "새로운 글로벌 MCP 서버 추가"를 클릭하세요.
  3. 위의 구성을 제공된 mcp.json 파일에 추가합니다.
  4. MCP 탭에서 연결이 활성화되어 있는지 확인하세요.

참고용 커서 MCP 문서 여기

VS 코드

  1. 설정 메뉴(Command + Comma)를 열고 사용 사례에 맞는 페이지 상단의 올바른 탭을 선택하세요.
    • Workspace - 작업 공간 컨텍스트에서 서버를 구성합니다.
    • User - 사용자 컨텍스트에서 서버를 구성합니다.
    • WSL 사용자 참고 사항 : VS Code를 WSL과 함께 사용하는 경우 WSL 관련 설정을 구성해야 합니다. 명령 팔레트(F1)에서 "환경 설정: 원격 설정 열기 " 명령을 실행하거나 설정 편집기에서 "원격" 탭을 선택하세요. 로컬 사용자 설정은 WSL에서 재사용되지만 WSL 관련 설정으로 재정의할 수 있습니다. 로컬 사용자 설정에서 MCP 서버를 구성하는 것은 WSL 환경에서는 제대로 작동하지 않습니다.
  2. 기능 선택 → 채팅
  3. "Mcp"가 Enabled 있는지 확인하세요

  1. "Mcp > Discovery"에서 "settings.json에서 편집"을 클릭하세요.
  2. 제공된 settings.json 파일에 서버 구성( dbt )을 서버 중 하나로 추가합니다.
{ "mcp": { "inputs": [], "servers": { "dbt": { "command": "<path-to-mcp-executable>", "args": ["run", "<path-to-this-directory>/src/dbt_mcp/main.py"] } } } }

<path-to-mcp-executable> OS에 따라 달라집니다.

  • Linux 및 Mac: <path-to-this-directory>/.venv/bin/mcp
  • PC: <path-to-this-directory>/.venv/Scripts/mcp
  1. 다음을 통해 MCP 서버를 시작, 중지 및 구성할 수 있습니다.
  • 명령 팔레트(Control + Command + P)에서 MCP: List Servers 명령을 실행하고 서버를 선택합니다.
  • settings.json 파일 내에서 키워드를 인라인으로 활용

참고용 VS Code MCP 문서는 여기 있습니다.

도구

DBT CLI

  • build - 종속성 순서대로 모델, 테스트, 스냅샷 및 시드를 실행합니다.
  • compile - 실행하지 않고도 모델, 테스트 및 분석에서 실행 가능한 SQL을 생성합니다.
  • docs - dbt 프로젝트에 대한 문서를 생성합니다.
  • ls (목록) - 모델 및 테스트와 같은 dbt 프로젝트의 리소스를 나열합니다.
  • parse - 프로젝트 파일을 구문 분석하고 구문이 정확한지 검증합니다.
  • run - 모델을 실행하여 데이터베이스에 구체화합니다.
  • test - 데이터 및 모델 무결성을 검증하기 위한 테스트를 실행합니다.
  • show - 데이터웨어하우스에 대한 쿼리를 실행합니다.

이 MCP 툴을 통해 클라이언트가 DBT 명령을 사용할 수 있도록 허용하면 데이터 모델, 소스 및 웨어하우스 객체가 수정될 수 있습니다. 클라이언트를 신뢰하고 잠재적 영향을 이해하는 경우에만 진행하십시오.

의미 계층

  • list_metrics - 정의된 모든 메트릭을 검색합니다.
  • get_dimensions - 지정된 메트릭과 연결된 차원을 가져옵니다.
  • get_entities - 지정된 메트릭과 연결된 엔터티를 가져옵니다.
  • query_metrics - 선택적 그룹화, 순서 지정, 필터링 및 제한을 사용하여 메트릭을 쿼리합니다.

발견

  • get_mart_models - 모든 마트 모델을 가져옵니다.
  • get_all_models - 모든 모델을 가져옵니다
  • get_model_details - 특정 모델에 대한 세부 정보를 가져옵니다.
  • get_model_parents - 특정 모델의 부모 모델을 가져옵니다.

기여하다

참여 방법에 대한 지침은 CONTRIBUTING.md 에서 확인하세요!

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

View all tools

dbt-mcp

  1. 건축학
    1. 설정
      1. 구성
        1. 도구 그룹
        2. 검색 및 의미 계층 구성
        3. 원격 도구 구성
        4. dbt CLI 구성
      2. MCP 클라이언트와 함께 사용
        1. 클로드 데스크탑
          1. 커서
            1. VS 코드
              1. 도구
                1. DBT CLI
                2. 의미 계층
                3. 발견
              2. 기여하다

                Related MCP Servers

                • MCP Toolbox for Databasesofficial

                  googleapis
                  -
                  security
                  A
                  license
                  -
                  quality
                  Open source MCP server specializing in easy, fast, and secure tools for Databases.
                  Last updated -
                  821
                  Go
                  Apache 2.0
                  • Linux

                • interactive-mcp

                  ttommyth
                  A
                  security
                  A
                  license
                  A
                  quality
                  interactive-mcp
                  Last updated -
                  5
                  705
                  29
                  TypeScript
                  MIT License
                  • Apple
                  • Linux

                View all related MCP servers

                ID: 4g56yk3tar