dbt MCP Server

dbt MCP 서버

이 MCP(모델 컨텍스트 프로토콜) 서버는 dbt와 상호 작용하기 위한 다양한 도구를 제공합니다. 이 MCP 서버를 사용하여 AI 에이전트에 dbt Core, dbt Fusion 및 dbt Platform의 프로젝트 컨텍스트를 제공할 수 있습니다.

자세한 내용은 여기 문서를 참조하세요. dbt MCP 서버로 가능한 작업에 대한 자세한 내용은 이 블로그 게시물에서 확인할 수 있습니다.

실험적 MCP 번들

MCPB 인식 클라이언트가 추가 설정 없이 이 서버를 가져올 수 있도록 각 릴리스와 함께 실험적 모델 컨텍스트 프로토콜 번들(dbt-mcp.mcpb)을 게시합니다. 최신 릴리스 자산에서 번들을 다운로드하고 Anthropic의 mcpb CLI 문서에 따라 설치하거나 검사하세요.

피드백

의견이나 질문이 있으시면 GitHub 이슈를 생성하거나 #tools-dbt-mcp 채널의 커뮤니티 Slack에 참여하세요.

아키텍처

dbt MCP 서버 아키텍처를 통해 에이전트가 다양한 도구에 연결할 수 있습니다.

도구

SQL

dbt Platform 인프라에서 SQL을 실행하고 생성하기 위한 도구입니다.

• execute_sql: 시맨틱 레이어 지원을 통해 dbt Platform 인프라에서 SQL을 실행합니다.
• text_to_sql: 프로젝트 컨텍스트를 사용하여 자연어에서 SQL을 생성합니다.

시맨틱 레이어

dbt 시맨틱 레이어에 대한 자세한 내용은 여기를 클릭하세요.

• get_dimension_values: 차원에 대한 고유 값을 가져옵니다. 특정 메트릭으로 범위를 지정하는 옵션이 있습니다.
• get_dimensions: 지정된 메트릭에 대한 차원을 가져옵니다.
• get_entities: 지정된 메트릭에 대한 엔티티를 가져옵니다.
• get_metrics_compiled_sql: 쿼리를 실행하지 않고 메트릭에 대해 컴파일된 SQL을 반환합니다.
• list_metrics: 정의된 모든 메트릭을 검색합니다.
• list_saved_queries: 저장된 모든 쿼리를 검색합니다.
• query_metrics: 필터링 및 그룹화 옵션을 사용하여 메트릭 쿼리를 실행합니다.

디스커버리

dbt 디스커버리 API에 대한 자세한 내용은 여기를 클릭하세요.

• get_all_macros: 매크로를 검색합니다. 패키지별로 필터링하거나 패키지 이름만 반환하는 옵션이 있습니다.
• get_all_models: 모든 모델의 이름과 설명을 검색합니다.
• get_all_sources: 최신 상태와 함께 모든 소스를 가져옵니다. 소스 이름별로 필터링하는 옵션이 있습니다.
• get_exposure_details: 소유자, 부모 및 최신 상태를 포함한 노출 세부 정보를 가져옵니다.
• get_exposures: 모든 노출(다운스트림 대시보드, 앱 또는 분석)을 가져옵니다.
• get_lineage: 유형 및 깊이 필터링을 사용하여 전체 계보 그래프(상위 및 하위)를 가져옵니다.
• get_macro_details: 특정 매크로에 대한 세부 정보를 가져옵니다.
• get_mart_models: 모든 마트 모델을 검색합니다.
• get_model_children: 모델의 다운스트림 종속 항목을 가져옵니다.
• get_model_details: 컴파일된 SQL, 열 및 스키마를 포함한 모델 세부 정보를 가져옵니다.
• get_model_health: 실행 상태, 테스트 결과 및 업스트림 소스 최신 상태와 같은 상태 신호를 가져옵니다.
• get_model_parents: 모델의 업스트림 종속성을 가져옵니다.
• get_model_performance: 모델에 대한 실행 기록을 가져옵니다. 테스트 결과를 포함하는 옵션이 있습니다.
• get_related_models: 시맨틱 검색을 사용하여 유사한 모델을 찾습니다.
• get_seed_details: 특정 시드에 대한 세부 정보를 가져옵니다.
• get_semantic_model_details: 특정 시맨틱 모델에 대한 세부 정보를 가져옵니다.
• get_snapshot_details: 특정 스냅샷에 대한 세부 정보를 가져옵니다.
• get_source_details: 열 및 최신 상태를 포함한 소스 세부 정보를 가져옵니다.
• get_test_details: 특정 테스트에 대한 세부 정보를 가져옵니다.
• search: [알파] dbt 프로젝트 전체에서 리소스를 검색합니다(일반적으로 사용할 수 없음).

dbt CLI

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

• build: DAG 순서로 모델, 테스트, 스냅샷 및 시드를 실행합니다.
• clone: 지정된 상태에서 대상 스키마로 선택한 노드를 복제합니다.
• compile: 모델/테스트/분석에서 실행 가능한 SQL을 생성합니다. Jinja 로직을 검증하는 데 유용합니다.
• docs: dbt 프로젝트에 대한 문서를 생성합니다.
• get_lineage_dev: 유형 및 깊이 필터링을 사용하여 로컬 manifest.json에서 계보를 검색합니다.
• get_node_details_dev: 로컬 manifest.json에서 노드 세부 정보(모델, 시드, 스냅샷, 소스)를 검색합니다.
• list: 선택기 지원을 통해 유형별로 dbt 프로젝트의 리소스를 나열합니다.
• parse: 구문 정확성을 위해 프로젝트 파일을 구문 분석하고 검증합니다.
• run: 데이터베이스에서 구체화하기 위해 모델을 실행합니다.
• show: 데이터베이스에 대해 SQL을 실행하고 결과를 반환합니다.
• test: 데이터 및 모델 무결성을 검증하기 위해 테스트를 실행합니다.

관리 API

dbt 관리 API에 대한 자세한 내용은 여기를 클릭하세요.

• cancel_job_run: 실행 중인 작업을 취소합니다.
• get_job_details: 트리거, 일정 및 dbt 명령을 포함한 작업 구성을 가져옵니다.
• get_job_run_details: 상태, 타이밍, 단계 및 아티팩트를 포함한 실행 세부 정보를 가져옵니다.
• get_job_run_error: 작업 실행에 대한 오류 및/또는 경고 세부 정보를 가져옵니다. 경고만 포함하거나 표시하는 옵션이 있습니다.
• list_job_run_artifacts: 작업 실행에서 사용 가능한 아티팩트를 나열합니다.
• list_jobs: dbt Platform 계정의 작업을 나열합니다. 프로젝트 또는 환경별로 필터링하는 옵션이 있습니다.
• list_jobs_runs: 작업 실행을 나열합니다. 작업, 상태별로 필터링하거나 필드별로 정렬하는 옵션이 있습니다.
• list_projects: dbt Platform 계정의 모든 프로젝트를 나열합니다.
• retry_job_run: 실패한 작업 실행을 다시 시도합니다.
• trigger_job_run: 작업 실행을 트리거합니다. git 브랜치, 스키마 또는 기타 설정을 재정의하는 옵션이 있습니다.

dbt Codegen

이러한 도구는 dbt 프로젝트 파일에 대한 상용구 코드 생성을 자동화하는 데 도움이 됩니다.

• generate_model_yaml: 열이 있는 모델 YAML을 생성합니다. 업스트림 설명을 상속하는 옵션이 있습니다.
• generate_source: 데이터베이스 스키마를 검사하여 소스 YAML을 생성합니다. 열을 포함하는 옵션이 있습니다.
• generate_staging_model: 소스 테이블에서 스테이징 모델 SQL을 생성합니다.

dbt LSP

고급 SQL 컴파일 및 열 수준 계보 분석을 위해 Fusion 엔진을 활용하는 도구 세트입니다.

• fusion.compile_sql: dbt Platform을 통해 프로젝트 컨텍스트에서 SQL을 컴파일합니다.
• fusion.get_column_lineage: dbt Platform을 통해 열 수준 계보를 추적합니다.
• get_column_lineage: 로컬에서 열 수준 계보를 추적합니다(dbt Labs VSCE를 통한 dbt-lsp 필요).

제품 문서

docs.getdbt.com의 공식 dbt 문서에서 콘텐츠를 검색하고 가져오기 위한 도구입니다.

• get_product_doc_pages: 경로 또는 URL로 하나 이상의 docs.getdbt.com 페이지의 전체 Markdown 콘텐츠를 가져옵니다.
• search_product_docs: 쿼리와 일치하는 페이지에 대해 docs.getdbt.com을 검색합니다. 관련성 순위가 매겨진 제목, URL 및 설명을 반환합니다. 전체 콘텐츠를 가져오려면 get_product_doc_pages를 사용하세요.

MCP 서버 메타데이터

이러한 도구는 MCP 서버 자체에 대한 정보를 제공합니다.

• get_mcp_server_branch: 실행 중인 dbt MCP 서버의 현재 git 브랜치를 반환합니다.
• get_mcp_server_version: dbt MCP 서버의 현재 버전을 반환합니다.

예제

일반적으로 dbt MCP 서버를 Claude 또는 Cursor와 같은 에이전트 제품에 연결합니다. 그러나 자체 에이전트를 만드는 데 관심이 있다면 시작하는 방법에 대한 예제 디렉터리를 확인하세요.

종속성

종속성은 특정 버전에 고정되어 있으며 자동으로 업데이트되지 않습니다. 보안 관련 종속성 업데이트만 자동화된 풀 리퀘스트를 통해 제출됩니다.

기여

참여 방법에 대한 지침은 CONTRIBUTING.md을 읽어보세요!