dbt

Máy chủ MCP dbt

Máy chủ MCP (Model Context Protocol) này cung cấp nhiều công cụ để tương tác với dbt. Bạn có thể sử dụng máy chủ MCP này để cung cấp cho các tác nhân AI ngữ cảnh về dự án của bạn trong dbt Core, dbt Fusion và dbt Platform.

Đọc tài liệu của chúng tôi tại đây để tìm hiểu thêm. Bài viết blog này cung cấp thêm chi tiết về những gì có thể thực hiện với máy chủ MCP dbt.

Gói MCP thử nghiệm

Chúng tôi xuất bản một Gói Model Context Protocol thử nghiệm (dbt-mcp.mcpb) trong mỗi bản phát hành để các máy khách hỗ trợ MCPB có thể nhập máy chủ này mà không cần thiết lập thêm. Tải gói từ các tài nguyên của bản phát hành mới nhất và làm theo tài liệu mcpb CLI của Anthropic để cài đặt hoặc kiểm tra nó.

Phản hồi

Nếu bạn có nhận xét hoặc câu hỏi, hãy tạo một GitHub Issue hoặc tham gia cùng chúng tôi trong Slack cộng đồng tại kênh #tools-dbt-mcp.

Kiến trúc

Kiến trúc máy chủ MCP dbt cho phép tác nhân của bạn kết nối với nhiều loại công cụ.

Công cụ

SQL

Các công cụ để thực thi và tạo SQL trên cơ sở hạ tầng dbt Platform.

• execute_sql: Thực thi SQL trên cơ sở hạ tầng dbt Platform với hỗ trợ Semantic Layer.
• text_to_sql: Tạo SQL từ ngôn ngữ tự nhiên bằng cách sử dụng ngữ cảnh dự án.

Semantic Layer

Để tìm hiểu thêm về dbt Semantic Layer, nhấp tại đây.

• get_dimension_values: Lấy các giá trị riêng biệt cho một thứ nguyên; có tùy chọn phạm vi cho các chỉ số cụ thể.
• get_dimensions: Lấy các thứ nguyên cho các chỉ số được chỉ định.
• get_entities: Lấy các thực thể cho các chỉ số được chỉ định.
• get_metrics_compiled_sql: Trả về SQL đã biên dịch cho các chỉ số mà không thực thi truy vấn.
• list_metrics: Truy xuất tất cả các chỉ số đã xác định.
• list_saved_queries: Truy xuất tất cả các truy vấn đã lưu.
• query_metrics: Thực thi các truy vấn chỉ số với các tùy chọn lọc và nhóm.

Discovery

Để tìm hiểu thêm về dbt Discovery API, nhấp tại đây.

• get_all_macros: Truy xuất các macro; có tùy chọn lọc theo gói hoặc chỉ trả về tên gói.
• get_all_models: Truy xuất tên và mô tả của tất cả các mô hình.
• get_all_sources: Lấy tất cả các nguồn với trạng thái độ tươi; có tùy chọn lọc theo tên nguồn.
• get_exposure_details: (không dùng nữa — sử dụng get_node_details thay thế)
• get_exposures: Lấy tất cả các exposure (bảng điều khiển, ứng dụng hoặc phân tích xuôi dòng).
• get_lineage: Lấy đồ thị lineage có giới hạn với bộ lọc loại, độ sâu và hướng.
• get_macro_details: (không dùng nữa — sử dụng get_node_details thay thế)
• get_mart_models: Truy xuất tất cả các mô hình mart.
• get_model_children: (không dùng nữa — sử dụng get_lineage thay thế)
• get_model_details: (không dùng nữa — sử dụng get_node_details thay thế)
• get_model_health: Lấy các tín hiệu sức khỏe: trạng thái chạy, kết quả kiểm tra và độ tươi của nguồn thượng nguồn.
• get_model_parents: (không dùng nữa — sử dụng get_lineage thay thế)
• get_model_performance: Lấy lịch sử thực thi cho một mô hình; có tùy chọn bao gồm kết quả kiểm tra.
• get_node_details: Lấy chi tiết đầy đủ cho bất kỳ loại tài nguyên dbt nào (mô hình, nguồn, exposure, kiểm tra, seed, snapshot, macro, semantic_model).
• get_related_models: Tìm các mô hình tương tự bằng cách sử dụng tìm kiếm ngữ nghĩa.
• get_seed_details: (không dùng nữa — sử dụng get_node_details thay thế)
• get_semantic_model_details: (không dùng nữa — sử dụng get_node_details thay thế)
• get_snapshot_details: (không dùng nữa — sử dụng get_node_details thay thế)
• get_source_details: (không dùng nữa — sử dụng get_node_details thay thế)
• get_test_details: (không dùng nữa — sử dụng get_node_details thay thế)
• search: [Alpha] Tìm kiếm các tài nguyên trong dự án dbt (chưa được phát hành rộng rãi).

dbt CLI

Cho phép máy khách của bạn sử dụng các lệnh dbt thông qua công cụ MCP có thể sửa đổi các mô hình dữ liệu, nguồn và đối tượng kho dữ liệu của bạn. Chỉ tiến hành nếu bạn tin tưởng máy khách và hiểu tác động tiềm ẩn.

• build: Thực thi các mô hình, kiểm tra, snapshot và seed theo thứ tự DAG.
• clone: Sao chép các nút đã chọn từ trạng thái được chỉ định vào (các) schema mục tiêu.
• compile: Tạo SQL có thể thực thi từ các mô hình/kiểm tra/phân tích; hữu ích để xác thực logic Jinja.
• docs: Tạo tài liệu cho dự án dbt.
• get_lineage_dev: Truy xuất lineage từ manifest.json cục bộ với bộ lọc loại và độ sâu.
• get_node_details_dev: Truy xuất chi tiết nút từ manifest.json cục bộ (mô hình, seed, snapshot, nguồn).
• list: Liệt kê các tài nguyên trong dự án dbt theo loại với hỗ trợ bộ chọn.
• parse: Phân tích cú pháp và xác thực các tệp dự án để đảm bảo tính đúng đắn của cú pháp.
• run: Thực thi các mô hình để vật chất hóa chúng trong cơ sở dữ liệu.
• show: Thực thi SQL đối với cơ sở dữ liệu và trả về kết quả.
• test: Chạy các kiểm tra để xác thực tính toàn vẹn của dữ liệu và mô hình.

Admin API

Để tìm hiểu thêm về dbt Administrative API, nhấp tại đây.

• cancel_job_run: Hủy một công việc đang chạy.
• get_job_details: Lấy cấu hình công việc bao gồm trình kích hoạt, lịch trình và lệnh dbt.
• get_job_run_artifacts: Tải xuống một artifact cụ thể từ một lần chạy công việc; các artifact lớn trả về thông báo hướng dẫn để thử lại với jq_filter; hỗ trợ lọc jq để trích xuất có mục tiêu.
• get_job_run_details: Lấy chi tiết lần chạy bao gồm trạng thái, thời gian, các bước và artifact.
• get_job_run_error: Lấy chi tiết lỗi và/hoặc cảnh báo cho một lần chạy công việc; có tùy chọn bao gồm hoặc chỉ hiển thị cảnh báo.
• list_job_run_artifacts: Liệt kê các artifact có sẵn từ một lần chạy công việc.
• list_jobs: Liệt kê các công việc trong tài khoản dbt Platform; có tùy chọn lọc theo dự án hoặc môi trường.
• list_jobs_runs: Liệt kê các lần chạy công việc; có tùy chọn lọc theo công việc, trạng thái hoặc trường sắp xếp.
• list_projects: Liệt kê tất cả các dự án trong tài khoản dbt Platform.
• retry_job_run: Thử lại một lần chạy công việc bị lỗi.
• trigger_job_run: Kích hoạt một lần chạy công việc; có tùy chọn ghi đè nhánh git, schema hoặc các cài đặt khác.

dbt Codegen

Các công cụ này giúp tự động hóa việc tạo mã boilerplate cho các tệp dự án dbt.

• generate_model_yaml: Tạo YAML mô hình với các cột; có tùy chọn kế thừa mô tả thượng nguồn.
• generate_source: Tạo YAML nguồn bằng cách kiểm tra các schema cơ sở dữ liệu; có tùy chọn bao gồm các cột.
• generate_staging_model: Tạo SQL mô hình staging từ một bảng nguồn.

dbt LSP

Một bộ công cụ tận dụng công cụ Fusion để biên dịch SQL nâng cao và phân tích lineage cấp cột.

• fusion.compile_sql: Biên dịch SQL trong ngữ cảnh dự án thông qua dbt Platform.
• fusion.get_column_lineage: Truy vết lineage cấp cột thông qua dbt Platform.
• get_column_lineage: Truy vết lineage cấp cột cục bộ (yêu cầu dbt-lsp thông qua dbt Labs VSCE).

Tài liệu sản phẩm

Các công cụ để tìm kiếm và tìm nạp nội dung từ tài liệu dbt chính thức tại docs.getdbt.com.

• get_product_doc_pages: Tìm nạp nội dung Markdown đầy đủ của một hoặc nhiều trang docs.getdbt.com theo đường dẫn hoặc URL.
• search_product_docs: Tìm kiếm docs.getdbt.com cho các trang khớp với truy vấn; trả về tiêu đề, URL và mô tả được xếp hạng theo mức độ liên quan. Sử dụng get_product_doc_pages để tìm nạp nội dung đầy đủ.

Siêu dữ liệu máy chủ MCP

Các công cụ này cung cấp thông tin về chính máy chủ MCP.

• get_mcp_server_branch: Trả về nhánh git hiện tại của máy chủ MCP dbt đang chạy.
• get_mcp_server_version: Trả về phiên bản hiện tại của máy chủ MCP dbt.

Ví dụ

Thông thường, bạn sẽ kết nối máy chủ MCP dbt với một sản phẩm tác nhân như Claude hoặc Cursor. Tuy nhiên, nếu bạn quan tâm đến việc tạo tác nhân của riêng mình, hãy xem thư mục ví dụ để biết cách bắt đầu.

Phụ thuộc

Các phụ thuộc được ghim vào các phiên bản cụ thể và không được cập nhật tự động. Chỉ các bản cập nhật phụ thuộc liên quan đến bảo mật mới được gửi qua các yêu cầu kéo tự động.

Đóng góp

Đọc CONTRIBUTING.md để biết hướng dẫn về cách tham gia!