dbt MCP Server

Bu MCP (Model Context Protocol) sunucusu dbt ile etkileşim kurmak için çeşitli araçlar sağlar. Bu MCP sunucusunu, AI ajanlarına dbt Core, dbt Fusion ve dbt Platform'daki projenizin bağlamını sağlamak için kullanabilirsiniz.

Daha fazla bilgi edinmek için buradaki belgelerimizi okuyun. Bu blog yazısı dbt MCP sunucusu ile neler mümkün olduğu hakkında daha fazla detay sağlar.

Deneysel MCP Bundle

Her sürümle birlikte deneysel bir Model Context Protocol Bundle (dbt-mcp.mcpb) yayınlıyoruz; böylece MCPB tarafından desteklenen istemciler bu sunucuyu ek kurulum olmadan içe aktarabilir. Bundle'ı en son sürüm varlıklarından indirin ve Anthropic'in mcpb CLI belgelerini izleyerek yükleyin veya inceleyin.

Geri Bildirim

Yorumlarınız veya sorularınız varsa, bir GitHub Issue oluşturun veya community Slack kanalımızda #tools-dbt-mcp kanalına katılın.

Mimari

dbt MCP sunucusu mimarisi, ajanınızın çeşitli araçlara bağlanmasını sağlar.

Araçlar

SQL

dbt Platform altyapısında SQL yürütmek ve oluşturmak için araçlar.

• execute_sql: dbt Platform altyapısında Semantic Layer desteğiyle SQL yürütür.
• text_to_sql: Proje bağlamını kullanarak doğal dilden SQL oluşturur.

Semantic Layer

dbt Semantic Layer hakkında daha fazla bilgi edinmek için buraya tıklayın.

• get_dimensions: Belirtilen metrikler için boyutları alır.
• get_entities: Belirtilen metrikler için varlıkları alır.
• get_metrics_compiled_sql: Sorguyu yürütmeden metrikler için derlenmiş SQL'i döndürür.
• list_metrics: Tanımlanmış tüm metrikleri alır.
• list_saved_queries: Kaydedilmiş tüm sorguları alır.
• query_metrics: Filtreleme ve gruplama seçenekleriyle metrik sorgularını yürütür.

Discovery

dbt Discovery API hakkında daha fazla bilgi edinmek için buraya tıklayın.

• get_all_macros: Makroları alır; pakete göre filtreleme veya yalnızca paket adlarını döndürme seçeneği.
• get_all_models: Tüm modellerin adını ve açıklamasını alır.
• get_all_sources: Tüm kaynakları tazelik durumuyla alır; kaynak adına göre filtreleme seçeneği.
• get_exposure_details: Sahibi, ebeveynleri ve tazelik durumunu içeren exposure ayrıntılarını alır.
• get_exposures: Tüm exposure'ları alır (aşağı akış panoları, uygulamalar veya analizler).
• get_lineage: Tam soy ağacı grafiğini (öncüller ve halefleri) tür ve derinlik filtrelemesiyle alır.
• get_macro_details: Belirli bir makro için ayrıntıları alır.
• get_mart_models: Tüm mart modellerini alır.
• get_model_children: Bir modelin aşağı akış bağımlılarını alır.
• get_model_details: Derlenmiş SQL, sütunlar ve şema içeren model ayrıntılarını alır.
• get_model_health: Sağlık sinyallerini alır: çalışma durumu, test sonuçları ve yukarı akış kaynağı tazeliği.
• get_model_parents: Bir modelin yukarı akış bağımlılıklarını alır.
• get_model_performance: Bir model için yürütme geçmişini alır; test sonuçlarını dahil etme seçeneği.
• get_related_models: Semantik aramayı kullanarak benzer modelleri bulur.
• get_seed_details: Belirli bir seed için ayrıntıları alır.
• get_semantic_model_details: Belirli bir semantic model için ayrıntıları alır.
• get_snapshot_details: Belirli bir snapshot için ayrıntıları alır.
• get_source_details: Sütunlar ve tazelik içeren kaynak ayrıntılarını alır.
• get_test_details: Belirli bir test için ayrıntıları alır.
• search: [Alpha] dbt projesi genelinde kaynakları arar (genel olarak kullanılamaz).

dbt CLI

İstemcinizin MCP araçları aracılığıyla dbt komutlarını kullanabilmesine izin vermek, veri modellerinizi, kaynaklarınızı ve warehouse nesnelerinizi değiştirebilir. Yalnızca istemciye güveniyorsanız ve potansiyel etkiyi anladıysanız devam edin.

• build: DAG sırasında modelleri, testleri, snapshot'ları ve seed'leri yürütür.
• clone: Belirtilen durumdan seçilen düğümleri hedef şema(lara) klonlar.
• compile: Modellerden/testlerden/analizlerden yürütülebilir SQL oluşturur; Jinja mantığını doğrulamak için faydalıdır.
• docs: dbt projesi için belgelendirme oluşturur.
• get_lineage_dev: Yerel manifest.json'dan tür ve derinlik filtrelemesiyle soy ağacını alır.
• get_node_details_dev: Yerel manifest.json'dan düğüm ayrıntılarını alır (modeller, seed'ler, snapshot'lar, kaynaklar).
• list: dbt projesindeki kaynakları türe göre seçici desteğiyle listeler.
• parse: Proje dosyalarını sözdizimi doğruluğu için ayrıştırır ve doğrular.
• run: Modelleri yürütür ve bunları veritabanında materyalize eder.
• show: Veritabanına karşı SQL yürütür ve sonuçları döndürür.
• test: Veri ve model bütünlüğünü doğrulamak için testleri çalıştırır.

Admin API

dbt Administrative API hakkında daha fazla bilgi edinmek için buraya tıklayın.

• cancel_job_run: Çalışan bir işi iptal eder.
• get_job_details: Tetikleyiciler, zamanlama ve dbt komutları dahil iş yapılandırmasını alır.
• get_job_run_details: Durumu, zamanlamayı, adımları ve yapıları içeren çalışma ayrıntılarını alır.
• get_job_run_error: İş çalışması için hata ve/veya uyarı ayrıntılarını alır; uyarıları dahil etme veya yalnızca uyarıları gösterme seçeneği.
• list_job_run_artifacts: Bir iş çalışmasından kullanılabilir yapıları listeler.
• list_jobs: dbt Platform hesabındaki işleri listeler; projeye veya ortama göre filtreleme seçeneği.
• list_jobs_runs: İş çalışmalarını listeler; işe, duruma göre filtreleme veya alan sırasına göre sıralama seçeneği.
• list_projects: dbt Platform hesabındaki tüm projeleri listeler.
• retry_job_run: Başarısız bir iş çalışmasını yeniden dener.
• trigger_job_run: Bir iş çalışmasını tetikler; git dalını, şemayı veya diğer ayarları geçersiz kılma seçeneği.

dbt Codegen

Bu araçlar, dbt proje dosyaları için yapı kodu oluşturmayı otomatikleştirmeye yardımcı olur.

• generate_model_yaml: Sütunlarla model YAML'ı oluşturur; yukarı akış açıklamalarını devralma seçeneği.
• generate_source: Veritabanı şemalarını inceleyerek kaynak YAML'ı oluşturur; sütunları dahil etme seçeneği.
• generate_staging_model: Bir kaynak tablosundan hazırlık modeli SQL'i oluşturur.

dbt LSP

Fusion motoru aracılığıyla gelişmiş SQL derlemesi ve sütun düzeyinde soy analizi için araçlar.

• fusion.compile_sql: dbt Platform üzerinden proje bağlamında SQL'i derler.
• fusion.get_column_lineage: dbt Platform üzerinden sütun düzeyinde soy ağacını izler.
• get_column_lineage: Yerel olarak sütun düzeyinde soy ağacını izler (dbt Labs VSCE aracılığıyla dbt-lsp gerektirir).

Product Docs

docs.getdbt.com adresindeki resmi dbt belgelerinde arama yapmak ve içerik getirmek için araçlar.

• get_product_doc_pages: Yol veya URL'ye göre bir veya daha fazla docs.getdbt.com sayfasının tam Markdown içeriğini getirir.
• search_product_docs: docs.getdbt.com'da bir sorguyla eşleşen sayfaları arar; başlıkları, URL'leri ve açıklamalarını alaka sırasına göre döndürür. Tam içeriği getirmek için get_product_doc_pages kullanın.

MCP Server Metadata

Bu araçlar, MCP sunucusunun kendisi hakkında bilgiler sağlar.

• get_mcp_server_branch: Çalışan dbt MCP sunucusunun mevcut git dalını döndürür.
• get_mcp_server_version: dbt MCP sunucusunun mevcut sürümünü döndürür.

Örnekler

Genellikle dbt MCP sunucusunu Claude veya Cursor gibi bir ajan ürününe bağlayacaksınız. Ancak kendi ajanınızı oluşturmakla ilgileniyorsanız, başlamak için örnekler dizinini kontrol edin.

Bağımlılıklar

Bağımlılıklar belirli sürümlere sabitlenmiş ve otomatik olarak güncellenmez. Yalnızca güvenlikle ilgili bağımlılık güncellemeleri otomatikleştirilmiş pull request'ler aracılığıyla sunulur.

Katkı

Nasıl katılacağınız hakkında talimatlar için CONTRIBUTING.md dosyasını okuyun!