dbt-labs/dbt-mcp

해결하는 문제

AI 에이전트와 dbt(데이터 빌드 툴) 프로젝트 사이의 격차를 해소합니다. 표준화된 인터페이스를 제공함으로써 AI 에이전트가 dbt 프로젝트의 컨텍스트를 이해하고, 데이터 웨어하우스와 상호작용하며, dbt 워크플로우를 관리할 수 있게 합니다. 에이전트가 dbt의 내부 API에 네이티브로 깊이 통합되어 있을 필요는 없습니다.

작동 방식

이 프로젝트는 Model Context Protocol (MCP) 서버를 구현합니다. 이 서버는 MCP 인식 AI 클라이언트(예: Claude 또는 Cursor)에게 dbt 전용 도구를 다수 노출하는 미들웨어 역할을 합니다. 이러한 도구를 통해 에이전트는 다음 카테고리에서 작업을 수행할 수 있습니다:

• SQL 및 세미틱 레이어: SQL 생성 및 실행, 정의된 메트릭 및 차원 쿼리
• 탐색: 프로젝트 메타데이터, 라인리지 그래프, 모델 건강 신호 가져오기
• dbt CLI: run, test, build 등의 핵심 dbt 명령어 직접 실행
• Admin API: 작업 실행 관리, 작업 트리거, 프로젝트 설정 검사
• Codegen: 모델 및 소스용 뼈대 YAML 및 SQL 자동 생성
• LSP: 고급 SQL 컴파일 및 컬럼 수준 라인리지 분석
• Product Docs: 공식 dbt 문서에서 콘텐츠 검색 및 가져오기

대상 사용자

• AI 에이전트 개발자: 데이터 변환 파이프라인과 상호작용해야 하는 사용자 정의 에이전트를 개발하는 사람
• 데이터 엔지니어: AI 기반 IDE나 에이전트를 사용하여 SQL을 작성하고, dbt 프로젝트를 관리하며, 문서를 자동화하고 싶은 사람

주요 특징

• 포괄적인 도구 세트: 저수준 CLI 명령어부터 고수준 세미틱 레이어 쿼리까지 모두 커버
• 라인리지 인식: 전체 라인리지 그래프를 가져오고 컬럼 수준 의존성 추적하는 도구 제공
• 자연어에서 SQL로 변환: 프로젝트 컨텍스트 기반으로 쿼리를 생성하는 text_to_sql 도구 포함
• 무결성 있는 통합: MCP 번들 지원으로 호환 클라이언트에 더 쉽게 설치 가능