dbt MCP Server

dbt MCP Server

MCP (Model Context Protocol) เซิร์ฟเวอร์นี้มีเครื่องมือหลากหลายสำหรับการโต้ตอบกับ dbt คุณสามารถใช้ MCP เซิร์ฟเวอร์นี้เพื่อให้บริบทของโปรเจกต์ของคุณใน dbt Core, dbt Fusion และ dbt Platform แก่เอเจนต์ AI

อ่านเอกสารของเรา ที่นี่ เพื่อเรียนรู้เพิ่มเติม บล็อกโพสต์นี้ ให้รายละเอียดเพิ่มเติมเกี่ยวกับสิ่งที่สามารถทำได้ด้วย dbt MCP เซิร์ฟเวอร์

Experimental MCP Bundle

เราเผยแพร่ Model Context Protocol Bundle (dbt-mcp.mcpb) แบบทดลองในแต่ละรุ่น เพื่อให้ไคลเอนต์ที่รองรับ MCPB สามารถนำเข้าเซิร์ฟเวอร์นี้ได้โดยไม่ต้องตั้งค่าเพิ่มเติม ดาวน์โหลดบันเดิลจาก assets ของรุ่นล่าสุด และทำตามเอกสาร mcpb CLI ของ Anthropic เพื่อติดตั้งหรือตรวจสอบ

ข้อเสนอแนะ

หากคุณมีความคิดเห็นหรือคำถาม สร้าง GitHub Issue หรือเข้าร่วมกับเราใน community Slack ในช่อง #tools-dbt-mcp

สถาปัตยกรรม

สถาปัตยกรรมของ dbt MCP เซิร์ฟเวอร์ช่วยให้เอเจนต์ของคุณเชื่อมต่อกับเครื่องมือที่หลากหลาย

เครื่องมือ

SQL

เครื่องมือสำหรับการดำเนินการและสร้าง SQL บนโครงสร้างพื้นฐานของ dbt Platform

• execute_sql: ดำเนินการ SQL บนโครงสร้างพื้นฐานของ dbt Platform พร้อมรองรับ Semantic Layer
• text_to_sql: สร้าง SQL จากภาษาธรรมชาติโดยใช้บริบทของโปรเจกต์

Semantic Layer

หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับ dbt Semantic Layer คลิก ที่นี่

• get_dimension_values: รับค่าที่แตกต่างสำหรับมิติข้อมูล; มีตัวเลือกในการจำกัดขอบเขตไปยังเมตริกเฉพาะ
• get_dimensions: รับมิติข้อมูลสำหรับเมตริกที่ระบุ
• get_entities: รับเอนทิตีสำหรับเมตริกที่ระบุ
• get_metrics_compiled_sql: ส่งคืน SQL ที่คอมไพล์แล้วสำหรับเมตริกโดยไม่ต้องดำเนินการคิวรี
• list_metrics: ดึงข้อมูลเมตริกทั้งหมดที่กำหนดไว้
• list_saved_queries: ดึงข้อมูล saved queries ทั้งหมด
• query_metrics: ดำเนินการคิวรีเมตริกพร้อมตัวเลือกการกรองและการจัดกลุ่ม

Discovery

หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับ dbt Discovery API คลิก ที่นี่

• get_all_macros: ดึงข้อมูลมาโคร; มีตัวเลือกในการกรองตามแพ็กเกจหรือส่งคืนเฉพาะชื่อแพ็กเกจ
• get_all_models: ดึงข้อมูลชื่อและคำอธิบายของโมเดลทั้งหมด
• get_all_sources: รับแหล่งข้อมูลทั้งหมดพร้อมสถานะความสดใหม่; มีตัวเลือกในการกรองตามชื่อแหล่งข้อมูล
• get_exposure_details: รับรายละเอียด exposure รวมถึงเจ้าของ, parents และสถานะความสดใหม่
• get_exposures: รับ exposure ทั้งหมด (แดชบอร์ด, แอป หรือการวิเคราะห์ปลายทาง)
• get_lineage: รับกราฟ lineage แบบเต็ม (ancestors และ descendants) พร้อมการกรองตามประเภทและความลึก
• get_macro_details: รับรายละเอียดสำหรับมาโครเฉพาะ
• get_mart_models: ดึงข้อมูล mart models ทั้งหมด
• get_model_children: รับ dependents ปลายทางของโมเดล
• get_model_details: รับรายละเอียดโมเดลรวมถึง SQL ที่คอมไพล์แล้ว, คอลัมน์ และ schema
• get_model_health: รับสัญญาณสุขภาพ: สถานะการรัน, ผลการทดสอบ และความสดใหม่ของแหล่งข้อมูลต้นทาง
• get_model_parents: รับ dependencies ต้นทางของโมเดล
• get_model_performance: รับประวัติการดำเนินการสำหรับโมเดล; มีตัวเลือกในการรวมผลการทดสอบ
• get_related_models: ค้นหาโมเดลที่คล้ายกันโดยใช้การค้นหาเชิงความหมาย
• get_seed_details: รับรายละเอียดสำหรับ seed เฉพาะ
• get_semantic_model_details: รับรายละเอียดสำหรับ semantic model เฉพาะ
• get_snapshot_details: รับรายละเอียดสำหรับ snapshot เฉพาะ
• get_source_details: รับรายละเอียดแหล่งข้อมูลรวมถึงคอลัมน์และความสดใหม่
• get_test_details: รับรายละเอียดสำหรับการทดสอบเฉพาะ
• search: [Alpha] ค้นหาทรัพยากรทั่วทั้งโปรเจกต์ dbt (ยังไม่พร้อมใช้งานทั่วไป)

dbt CLI

การอนุญาตให้ไคลเอนต์ของคุณใช้คำสั่ง dbt ผ่านเครื่องมือ MCP อาจปรับเปลี่ยนโมเดลข้อมูล, แหล่งข้อมูล และออบเจกต์คลังข้อมูลของคุณ ดำเนินการต่อเมื่อคุณเชื่อถือไคลเอนต์และเข้าใจผลกระทบที่อาจเกิดขึ้นเท่านั้น

• build: ดำเนินการโมเดล, การทดสอบ, snapshots และ seeds ตามลำดับ DAG
• clone: โคลนโหนดที่เลือกจากสถานะที่ระบุไปยัง schema เป้าหมาย
• compile: สร้าง SQL ที่ดำเนินการได้จากโมเดล/การทดสอบ/การวิเคราะห์; มีประโยชน์สำหรับการตรวจสอบตรรกะ Jinja
• docs: สร้างเอกสารสำหรับโปรเจกต์ dbt
• get_lineage_dev: ดึงข้อมูล lineage จาก manifest.json ในเครื่อง พร้อมการกรองตามประเภทและความลึก
• get_node_details_dev: ดึงข้อมูลรายละเอียดโหนดจาก manifest.json ในเครื่อง (โมเดล, seeds, snapshots, แหล่งข้อมูล)
• list: แสดงรายการทรัพยากรในโปรเจกต์ dbt ตามประเภท พร้อมรองรับตัวเลือก
• parse: แยกวิเคราะห์และตรวจสอบไฟล์โปรเจกต์เพื่อความถูกต้องของไวยากรณ์
• run: ดำเนินการโมเดลเพื่อทำให้เป็นรูปธรรมในฐานข้อมูล
• show: ดำเนินการ SQL กับฐานข้อมูลและส่งคืนผลลัพธ์
• test: รันการทดสอบเพื่อตรวจสอบความสมบูรณ์ของข้อมูลและโมเดล

Admin API

หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับ dbt Administrative API คลิก ที่นี่

• cancel_job_run: ยกเลิกงานที่กำลังทำงานอยู่
• get_job_details: รับการกำหนดค่างานรวมถึงทริกเกอร์, กำหนดการ และคำสั่ง dbt
• get_job_run_details: รับรายละเอียดการรันรวมถึงสถานะ, เวลา, ขั้นตอน และ artifacts
• get_job_run_error: รับรายละเอียดข้อผิดพลาดและ/หรือคำเตือนสำหรับการรันงาน; มีตัวเลือกในการรวมหรือแสดงเฉพาะคำเตือน
• list_job_run_artifacts: แสดงรายการ artifacts ที่มีอยู่จากการรันงาน
• list_jobs: แสดงรายการงานในบัญชี dbt Platform; มีตัวเลือกในการกรองตามโปรเจกต์หรือสภาพแวดล้อม
• list_jobs_runs: แสดงรายการการรันงาน; มีตัวเลือกในการกรองตามงาน, สถานะ หรือจัดลำดับตามฟิลด์
• list_projects: แสดงรายการโปรเจกต์ทั้งหมดในบัญชี dbt Platform
• retry_job_run: ลองใหม่สำหรับการรันงานที่ล้มเหลว
• trigger_job_run: ทริกเกอร์การรันงาน; มีตัวเลือกในการเขียนทับ git branch, schema หรือการตั้งค่าอื่นๆ

dbt Codegen

เครื่องมือเหล่านี้ช่วยสร้างโค้ด boilerplate โดยอัตโนมัติสำหรับไฟล์โปรเจกต์ dbt

• generate_model_yaml: สร้างโมเดล YAML พร้อมคอลัมน์; มีตัวเลือกในการสืบทอดคำอธิบายจากต้นทาง
• generate_source: สร้าง source YAML โดยการตรวจสอบ schema ฐานข้อมูล; มีตัวเลือกในการรวมคอลัมน์
• generate_staging_model: สร้าง staging model SQL จากตารางต้นทาง

dbt LSP

ชุดเครื่องมือที่ใช้ประโยชน์จากเอนจิน Fusion สำหรับการคอมไพล์ SQL ขั้นสูงและการวิเคราะห์ lineage ระดับคอลัมน์

• fusion.compile_sql: คอมไพล์ SQL ในบริบทของโปรเจกต์ผ่าน dbt Platform
• fusion.get_column_lineage: ติดตาม lineage ระดับคอลัมน์ผ่าน dbt Platform
• get_column_lineage: ติดตาม lineage ระดับคอลัมน์ในเครื่อง (ต้องใช้ dbt-lsp ผ่าน dbt Labs VSCE)

เอกสารผลิตภัณฑ์

เครื่องมือสำหรับการค้นหาและดึงเนื้อหาจากเอกสารทางการของ dbt ที่ docs.getdbt.com

• get_product_doc_pages: ดึงเนื้อหา Markdown แบบเต็มของหน้าหนึ่งหน้าหรือมากกว่าจาก docs.getdbt.com ตามพาธหรือ URL
• search_product_docs: ค้นหา docs.getdbt.com สำหรับหน้าที่ตรงกับคิวรี; ส่งคืนชื่อเรื่อง, URL และคำอธิบายที่จัดอันดับตามความเกี่ยวข้อง ใช้ get_product_doc_pages เพื่อดึงเนื้อหาฉบับเต็ม

ข้อมูลเมตาของ MCP Server

เครื่องมือเหล่านี้ให้ข้อมูลเกี่ยวกับ MCP เซิร์ฟเวอร์เอง

• get_mcp_server_branch: ส่งคืน git branch ปัจจุบันของ dbt MCP เซิร์ฟเวอร์ที่กำลังทำงานอยู่
• get_mcp_server_version: ส่งคืนเวอร์ชันปัจจุบันของ dbt MCP เซิร์ฟเวอร์

ตัวอย่าง

โดยทั่วไป คุณจะเชื่อมต่อ dbt MCP เซิร์ฟเวอร์กับผลิตภัณฑ์เอเจนต์เช่น Claude หรือ Cursor อย่างไรก็ตาม หากคุณสนใจที่จะสร้างเอเจนต์ของคุณเอง ลองดู ไดเรกทอรีตัวอย่าง สำหรับวิธีการเริ่มต้น

การพึ่งพา

การพึ่งพาถูกตรึงไว้ที่เวอร์ชันเฉพาะและไม่ได้รับการอัปเดตโดยอัตโนมัติ เฉพาะการอัปเดตการพึ่งพาที่เกี่ยวข้องกับความปลอดภัยเท่านั้นที่ถูกส่งผ่าน pull request อัตโนมัติ

การมีส่วนร่วม

อ่าน CONTRIBUTING.md สำหรับคำแนะนำเกี่ยวกับวิธีการเข้าร่วม!