dbt MCP Server

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 kepada agen AI di dbt Core, dbt Fusion, dan dbt Platform.

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

Bundel MCP Eksperimental

Kami menerbitkan Bundel Model Context Protocol eksperimental (dbt-mcp.mcpb) dengan setiap rilis sehingga klien yang sadar MCPB dapat mengimpor server ini tanpa pengaturan tambahan. Unduh bundel dari aset rilis terbaru dan ikuti dokumentasi mcpb CLI 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 di infrastruktur dbt Platform.

• execute_sql: Mengeksekusi SQL di 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 unik untuk suatu 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 yang disimpan.
• 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: Mendapatkan detail eksposur termasuk pemilik, induk, dan status kesegaran.
• get_exposures: Mendapatkan semua eksposur (dasbor, aplikasi, atau analisis hilir).
• get_lineage: Mendapatkan grafik garis keturunan lengkap (leluhur dan keturunan) dengan pemfilteran tipe dan kedalaman.
• get_macro_details: Mendapatkan detail untuk makro tertentu.
• get_mart_models: Mengambil semua model mart.
• get_model_children: Mendapatkan dependen hilir dari suatu model.
• get_model_details: Mendapatkan detail model termasuk SQL yang dikompilasi, kolom, dan skema.
• get_model_health: Mendapatkan sinyal kesehatan: status eksekusi, hasil pengujian, dan kesegaran sumber hulu.
• get_model_parents: Mendapatkan dependensi hulu dari suatu model.
• get_model_performance: Mendapatkan riwayat eksekusi untuk suatu model; opsi untuk menyertakan hasil pengujian.
• get_related_models: Menemukan model serupa menggunakan pencarian semantik.
• get_seed_details: Mendapatkan detail untuk seed tertentu.
• get_semantic_model_details: Mendapatkan detail untuk model semantik tertentu.
• get_snapshot_details: Mendapatkan detail untuk snapshot tertentu.
• get_source_details: Mendapatkan detail sumber termasuk kolom dan kesegaran.
• get_test_details: Mendapatkan detail untuk pengujian tertentu.
• search: [Alpha] Mencari sumber daya di seluruh proyek dbt (belum tersedia secara umum).

dbt CLI

Mengizinkan klien Anda untuk menggunakan perintah dbt melalui alat MCP dapat memodifikasi model data, sumber, dan objek gudang Anda. Lanjutkan hanya jika Anda memercayai klien dan memahami dampak potensialnya.

• 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 garis keturunan 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: Mencantumkan 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 integritas data dan model.

Admin API

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

• cancel_job_run: Membatalkan pekerjaan yang sedang berjalan.
• get_job_details: Mendapatkan konfigurasi pekerjaan termasuk pemicu, jadwal, dan perintah dbt.
• get_job_run_details: Mendapatkan detail eksekusi termasuk status, waktu, langkah, dan artefak.
• get_job_run_error: Mendapatkan detail kesalahan dan/atau peringatan untuk eksekusi pekerjaan; opsi untuk menyertakan atau hanya menampilkan peringatan.
• list_job_run_artifacts: Mencantumkan artefak yang tersedia dari eksekusi pekerjaan.
• list_jobs: Mencantumkan pekerjaan di akun dbt Platform; opsi untuk memfilter berdasarkan proyek atau lingkungan.
• list_jobs_runs: Mencantumkan eksekusi pekerjaan; opsi untuk memfilter berdasarkan pekerjaan, status, atau mengurutkan berdasarkan bidang.
• list_projects: Mencantumkan semua proyek di akun dbt Platform.
• retry_job_run: Mencoba ulang eksekusi pekerjaan yang gagal.
• trigger_job_run: Memicu eksekusi pekerjaan; 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 mengintrospeksi skema database; opsi untuk menyertakan kolom.
• generate_staging_model: Menghasilkan SQL model staging dari tabel sumber.

dbt LSP

Seperangkat alat yang memanfaatkan mesin Fusion untuk kompilasi SQL tingkat lanjut dan analisis garis keturunan tingkat kolom.

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

Dokumen 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 beberapa halaman docs.getdbt.com berdasarkan jalur atau URL.
• search_product_docs: Mencari halaman di docs.getdbt.com yang cocok dengan kueri; mengembalikan judul, URL, dan deskripsi yang diurutkan berdasarkan relevansi. Gunakan get_product_doc_pages untuk mengambil konten lengkap.

Metadata Server MCP

Alat-alat ini menyediakan 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 disematkan ke versi tertentu dan tidak diperbarui secara otomatis. Hanya pembaruan dependensi terkait keamanan yang dikirimkan melalui pull request otomatis.

Berkontribusi

Baca CONTRIBUTING.md untuk instruksi tentang cara terlibat!