dbt

Server MCP dbt

Server MCP (Model Context Protocol) ini menyediakan berbagai alat untuk berinteraksi dengan dbt. Anda dapat menggunakan server MCP ini untuk memberikan konteks proyek Anda di dbt Core, dbt Fusion, dan dbt Platform kepada agen AI.

Baca dokumentasi kami di sini untuk mempelajari lebih lanjut. Postingan blog ini memberikan detail lebih lanjut tentang apa yang dapat dilakukan dengan server MCP dbt.

Bundel MCP Eksperimental

Kami menerbitkan Bundel Model Context Protocol eksperimental (dbt-mcp.mcpb) dengan setiap rilis sehingga klien yang mendukung MCPB dapat mengimpor server ini tanpa pengaturan tambahan. Unduh bundel dari aset rilis terbaru dan ikuti dokumentasi mcpb CLI milik Anthropic untuk menginstal atau memeriksanya.

Umpan Balik

Jika Anda memiliki komentar atau pertanyaan, buat GitHub Issue atau bergabunglah dengan kami di Slack komunitas di saluran #tools-dbt-mcp.

Arsitektur

Arsitektur server MCP dbt memungkinkan agen Anda terhubung ke berbagai alat.

Alat

SQL

Alat untuk mengeksekusi dan menghasilkan SQL pada infrastruktur dbt Platform.

• execute_sql: Mengeksekusi SQL pada infrastruktur dbt Platform dengan dukungan Semantic Layer.
• text_to_sql: Menghasilkan SQL dari bahasa alami menggunakan konteks proyek.

Semantic Layer

Untuk mempelajari lebih lanjut tentang dbt Semantic Layer, klik di sini.

• get_dimension_values: Mendapatkan nilai yang berbeda untuk sebuah dimensi; opsi untuk membatasi ke metrik tertentu.
• get_dimensions: Mendapatkan dimensi untuk metrik yang ditentukan.
• get_entities: Mendapatkan entitas untuk metrik yang ditentukan.
• get_metrics_compiled_sql: Mengembalikan SQL yang dikompilasi untuk metrik tanpa mengeksekusi kueri.
• list_metrics: Mengambil semua metrik yang ditentukan.
• list_saved_queries: Mengambil semua kueri tersimpan.
• query_metrics: Mengeksekusi kueri metrik dengan opsi pemfilteran dan pengelompokan.

Discovery

Untuk mempelajari lebih lanjut tentang dbt Discovery API, klik di sini.

• get_all_macros: Mengambil makro; opsi untuk memfilter berdasarkan paket atau hanya mengembalikan nama paket.
• get_all_models: Mengambil nama dan deskripsi semua model.
• get_all_sources: Mendapatkan semua sumber dengan status kesegaran; opsi untuk memfilter berdasarkan nama sumber.
• get_exposure_details: (tidak digunakan lagi — gunakan get_node_details sebagai gantinya)
• get_exposures: Mendapatkan semua eksposur (dasbor hilir, aplikasi, atau analisis).
• get_lineage: Mendapatkan grafik lineage terbatas dengan pemfilteran tipe, kedalaman, dan arah.
• get_macro_details: (tidak digunakan lagi — gunakan get_node_details sebagai gantinya)
• get_mart_models: Mengambil semua model mart.
• get_model_children: (tidak digunakan lagi — gunakan get_lineage sebagai gantinya)
• get_model_details: (tidak digunakan lagi — gunakan get_node_details sebagai gantinya)
• get_model_health: Mendapatkan sinyal kesehatan: status proses, hasil pengujian, dan kesegaran sumber hulu.
• get_model_parents: (tidak digunakan lagi — gunakan get_lineage sebagai gantinya)
• get_model_performance: Mendapatkan riwayat eksekusi untuk sebuah model; opsi untuk menyertakan hasil pengujian.
• get_node_details: Mendapatkan detail lengkap untuk semua jenis sumber daya dbt (model, sumber, eksposur, pengujian, seed, snapshot, makro, semantic_model).
• get_related_models: Menemukan model serupa menggunakan pencarian semantik.
• get_seed_details: (tidak digunakan lagi — gunakan get_node_details sebagai gantinya)
• get_semantic_model_details: (tidak digunakan lagi — gunakan get_node_details sebagai gantinya)
• get_snapshot_details: (tidak digunakan lagi — gunakan get_node_details sebagai gantinya)
• get_source_details: (tidak digunakan lagi — gunakan get_node_details sebagai gantinya)
• get_test_details: (tidak digunakan lagi — gunakan get_node_details sebagai gantinya)
• search: [Alpha] Mencari sumber daya di seluruh proyek dbt (belum tersedia secara umum).

dbt CLI

Mengizinkan klien Anda menggunakan perintah dbt melalui alat MCP dapat mengubah model data, sumber, dan objek gudang data Anda. Lanjutkan hanya jika Anda mempercayai klien dan memahami potensi dampaknya.

• build: Mengeksekusi model, pengujian, snapshot, dan seed dalam urutan DAG.
• clone: Mengkloning node yang dipilih dari status yang ditentukan ke skema target.
• compile: Menghasilkan SQL yang dapat dieksekusi dari model/pengujian/analisis; berguna untuk memvalidasi logika Jinja.
• docs: Menghasilkan dokumentasi untuk proyek dbt.
• get_lineage_dev: Mengambil lineage dari manifest.json lokal dengan pemfilteran tipe dan kedalaman.
• get_node_details_dev: Mengambil detail node dari manifest.json lokal (model, seed, snapshot, sumber).
• list: Mendaftar sumber daya dalam proyek dbt berdasarkan tipe dengan dukungan pemilih.
• parse: Mengurai dan memvalidasi file proyek untuk kebenaran sintaks.
• run: Mengeksekusi model untuk mewujudkannya di database.
• show: Mengeksekusi SQL terhadap database dan mengembalikan hasil.
• test: Menjalankan pengujian untuk memvalidasi data dan integritas model.

Admin API

Untuk mempelajari lebih lanjut tentang dbt Administrative API, klik di sini.

• cancel_job_run: Membatalkan proses yang sedang berjalan.
• get_job_details: Mendapatkan konfigurasi proses termasuk pemicu, jadwal, dan perintah dbt.
• get_job_run_artifacts: Mengunduh artefak tertentu dari proses; artefak besar mengembalikan pesan panduan untuk mencoba lagi dengan jq_filter; mendukung pemfilteran jq untuk ekstraksi yang ditargetkan.
• get_job_run_details: Mendapatkan detail proses termasuk status, waktu, langkah, dan artefak.
• get_job_run_error: Mendapatkan detail kesalahan dan/atau peringatan untuk proses; opsi untuk menyertakan atau hanya menampilkan peringatan.
• list_job_run_artifacts: Mendaftar artefak yang tersedia dari proses.
• list_jobs: Mendaftar proses dalam akun dbt Platform; opsi untuk memfilter berdasarkan proyek atau lingkungan.
• list_jobs_runs: Mendaftar proses; opsi untuk memfilter berdasarkan proses, status, atau bidang urutan.
• list_projects: Mendaftar semua proyek dalam akun dbt Platform.
• retry_job_run: Mencoba ulang proses yang gagal.
• trigger_job_run: Memicu proses; opsi untuk menimpa cabang git, skema, atau pengaturan lainnya.

dbt Codegen

Alat-alat ini membantu mengotomatiskan pembuatan kode boilerplate untuk file proyek dbt.

• generate_model_yaml: Menghasilkan YAML model dengan kolom; opsi untuk mewarisi deskripsi hulu.
• generate_source: Menghasilkan YAML sumber dengan memeriksa skema database; opsi untuk menyertakan kolom.
• generate_staging_model: Menghasilkan SQL model staging dari tabel sumber.

dbt LSP

Serangkaian alat yang memanfaatkan mesin Fusion untuk kompilasi SQL tingkat lanjut dan analisis lineage tingkat kolom.

• fusion.compile_sql: Mengompilasi SQL dalam konteks proyek melalui dbt Platform.
• fusion.get_column_lineage: Melacak lineage tingkat kolom melalui dbt Platform.
• get_column_lineage: Melacak lineage tingkat kolom secara lokal (memerlukan dbt-lsp melalui dbt Labs VSCE).

Dokumentasi Produk

Alat untuk mencari dan mengambil konten dari dokumentasi resmi dbt di docs.getdbt.com.

• get_product_doc_pages: Mengambil konten Markdown lengkap dari satu atau lebih halaman docs.getdbt.com berdasarkan jalur atau URL.
• search_product_docs: Mencari docs.getdbt.com untuk halaman yang cocok dengan kueri; mengembalikan judul, URL, dan deskripsi yang diperingkat berdasarkan relevansi. Gunakan get_product_doc_pages untuk mengambil konten lengkap.

Metadata Server MCP

Alat-alat ini memberikan informasi tentang server MCP itu sendiri.

• get_mcp_server_branch: Mengembalikan cabang git saat ini dari server MCP dbt yang berjalan.
• get_mcp_server_version: Mengembalikan versi saat ini dari server MCP dbt.

Contoh

Umumnya, Anda akan menghubungkan server MCP dbt ke produk agen seperti Claude atau Cursor. Namun, jika Anda tertarik untuk membuat agen Anda sendiri, lihat direktori contoh untuk cara memulai.

Dependensi

Dependensi dipatok ke versi tertentu dan tidak diperbarui secara otomatis. Hanya pembaruan dependensi terkait keamanan yang dikirimkan melalui pull request otomatis.

Kontribusi

Baca CONTRIBUTING.md untuk instruksi tentang cara terlibat!