dbt-docs-mcp

dbt-docs-mcp

DBT Docs 아티팩트( manifest.json , catalog.json )를 포함한 DBT 프로젝트 메타데이터와 상호 작용하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 DBT 그래프 정보를 노출하고 노드 세부 정보, 모델/열 계보 및 관련 메타데이터를 쿼리할 수 있도록 합니다.

주요 기능

이 서버는 다음 도구를 제공합니다.

• dbt 노드 검색:
  • 이름으로 노드(모델, 소스, 테스트 등)를 찾습니다( search_dbt_node_names ).
  • 열 이름을 기준으로 노드를 찾습니다( search_dbt_column_names ).
  • 노드의 컴파일된 SQL 코드 내에서 검색합니다( search_dbt_sql_code ).
• 노드 검사:
  • 주어진 노드 고유 ID에 대한 자세한 속성을 검색합니다( get_dbt_node_attributes ).
• 혈통 탐색:
  • 노드의 직접 업스트림 종속성(전임자)을 찾습니다( get_dbt_predecessors ).
  • 노드의 직접 하위 종속 항목(후속 항목)을 찾습니다( get_dbt_successors ).
• 열 수준 계보:
  • 모델의 특정 열에 대한 모든 업스트림 소스를 추적합니다( get_column_ancestors ).
  • 모델의 특정 열의 모든 하위 종속 항목을 추적합니다( get_column_descendants ).
• 제안된 확장자:
  • SQL 쿼리를 실행할 수 있는 도구입니다.
  • 데이터베이스에서 테이블/뷰/열 메타데이터를 직접 검색하는 도구입니다.
  • 지식기반을 검색하는 도구.

시작하기

1. 필수 조건: Python과 uv가 설치되어 있는지 확인하세요.
2. 저장소를 복제합니다.지엑스피1
3. 선택 사항: 열 수준 계보에 대한 dbt 매니페스트 구문 분석:
   • 필요한 Python 환경 설정(예: GXP2)
   • 제공된 스크립트 scripts/create_manifest_cl.py 사용하고 DBT 매니페스트, DBT 카탈로그 및 스키마와 열 계통 파일에 대한 원하는 출력 경로만 제공하세요: GXP3
   • DBT 프로젝트 크기에 따라 열 계보를 만드는 데 시간이 오래 걸릴 수 있습니다(수시간).
4. 서버를 실행합니다:
   • 원하는 MCP 클라이언트(Claude 데스크톱, Cursor 등)가 mcp.json을 지원하는 경우 아래와 같습니다. GXP4