dbt MCP 서버
이 MCP(Model Context Protocol) 서버는 DBT와 상호 작용하는 도구를 제공합니다. 자세한 내용은 이 블로그를 참조하세요.
건축학
Related MCP server: dart-mcp
설정
저장소를 복제합니다.
지엑스피1
그런 다음 특정 환경 변수로 .env 편집합니다( README.md 의 Configuration 섹션 참조).
구성
MCP 서버는 다음과 같은 구성을 취합니다.
도구 그룹
이름 | 기본 | 설명 |
|
| dbt Core 및 dbt Cloud CLI MCP 도구를 비활성화하려면 이를 |
|
| dbt Semantic Layer MCP 객체를 비활성화하려면 이것을 |
|
| dbt Discovery API MCP 객체를 비활성화하려면 이것을 |
|
| 원격 MCP 객체를 활성화하려면 이것을 |
검색 및 의미 계층 구성
이름 | 기본 | 설명 |
|
| DBT 클라우드 인스턴스 호스트 이름입니다. 이 이름은 여기에서 찾을 수 있는 |
| - | 다중 셀을 사용하는 경우 이 환경 변수를 |
| - | 개인 액세스 토큰 또는 서비스 토큰입니다. 참고: Semantic Layer를 사용할 때는 서비스 토큰이 필요합니다. |
| - | 귀하의 dbt Cloud 프로덕션 환경 ID |
원격 도구 구성
이름 | 설명 |
| 귀하의 dbt Cloud 개발 환경 ID |
| 귀하의 dbt Cloud 사용자 ID |
dbt CLI 구성
이름 | 설명 |
| dbt 프로젝트의 저장소가 로컬에 호스팅되는 경로입니다. |
| dbt Core 또는 dbt Cloud CLI 실행 파일의 경로입니다. |
MCP 클라이언트와 함께 사용
설치 가 끝나면 MCP 클라이언트와 함께 서버를 사용할 수 있습니다.
이 구성은 해당 클라이언트의 설정 파일에 추가됩니다. <> 안의 섹션을 다음과 같이 바꿔주세요.
<path-to-mcp-executable> OS에 따라 달라집니다.
Linux 및 Mac:
<path-to-this-directory>/.venv/bin/mcpPC:
<path-to-this-directory>/.venv/Scripts/mcp
클로드 데스크탑
다음 지침에 따라 claude_desktop_config.json 파일을 만들고 연결하세요.
Mac에서는 Claude Desktop 로그를 ~/Library/Logs/Claude 에서 찾을 수 있습니다.
커서
커서 메뉴를 열고 설정 → 커서 설정 → MCP를 선택하세요.
"새로운 글로벌 MCP 서버 추가"를 클릭하세요.
위의 구성을 제공된
mcp.json파일에 추가합니다.MCP 탭에서 연결이 활성화되어 있는지 확인하세요.
참고용 커서 MCP 문서 여기
VS 코드
설정 메뉴(Command + Comma)를 열고 사용 사례에 맞는 페이지 상단의 올바른 탭을 선택하세요.
Workspace- 작업 공간 컨텍스트에서 서버를 구성합니다.User- 사용자 컨텍스트에서 서버를 구성합니다.WSL 사용자 참고 사항 : VS Code를 WSL과 함께 사용하는 경우 WSL 관련 설정을 구성해야 합니다. 명령 팔레트(F1)에서 "환경 설정: 원격 설정 열기 " 명령을 실행하거나 설정 편집기에서 "원격" 탭을 선택하세요. 로컬 사용자 설정은 WSL에서 재사용되지만 WSL 관련 설정으로 재정의할 수 있습니다. 로컬 사용자 설정에서 MCP 서버를 구성하는 것은 WSL 환경에서는 제대로 작동하지 않습니다.
기능 선택 → 채팅
"Mcp"가
Enabled있는지 확인하세요
"Mcp > Discovery"에서 "settings.json에서 편집"을 클릭하세요.
제공된
settings.json파일에 서버 구성(dbt)을 서버 중 하나로 추가합니다.
<path-to-mcp-executable> OS에 따라 달라집니다.
Linux 및 Mac:
<path-to-this-directory>/.venv/bin/mcpPC:
<path-to-this-directory>/.venv/Scripts/mcp
다음을 통해 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- 특정 모델의 부모 노드를 가져옵니다.get_model_children- 특정 모델의 자식 모드를 가져옵니다.
기여하다
참여 방법에 대한 지침은 CONTRIBUTING.md 에서 확인하세요!