Dbt Semantic Layer MCP Server

🚀 dbt語義層MCP服務器

一個用於通過Claude Desktop和其他兼容的AI助手無縫查詢dbt語義層的Model-Connector-Presenter (MCP)服務器，讓你能借助AI助手以自然語言便捷地與dbt語義層交互，獲取所需數據。

🚀 快速開始

本MCP服務器能讓你通過AI助手（如Claude）與dbt語義層建立連接，實現自然語言查詢指標、瀏覽指標定義等功能。在開始前，你需要具備啟用語義層的dbt Cloud賬戶、dbt Cloud實例的API訪問權限以及Node.js（v14或更高版本）。

✨ 主要特性

• 🔍 指標發現：可瀏覽和搜索dbt語義層中的可用指標。
• 📊 查詢創建：通過自然語言生成並執行語義查詢。
• 🧮 數據計算：支持篩選、分組和排序以獲取更深入的見解。
• 📈 結果可視化：以易於理解的格式顯示查詢結果。

📦 安裝指南

通過Smithery（推薦）

最簡單的安裝方式是通過Smithery，使用以下命令進行安裝：

npx -y @smithery/cli install @TommyBez/dbt-semantic-layer-mcp --client claude

💻 使用示例

基礎用法

安裝並配置完成後，你可以直接從Claude Desktop與dbt語義層交互，例如：

1. 詢問可用指標：“在我的dbt語義層中有哪些指標？”
2. 查詢特定指標：“顯示上季度按產品類別劃分的月度收入”
3. 分析趨勢：“用戶註冊量的周環比增長是多少？”

📚 詳細文檔

什麼是dbt語義層？

dbt語義層是一個強大的功能，允許你在dbt項目中一次定義指標，並在整個數據堆棧中一致地重用它們。它提供：

• 指標事實的單一來源
• 數據工具之間一致的指標定義
• 簡化複雜指標供所有團隊成員使用

關於該項目

這個MCP服務器充當AI助手（如Claude）和dbt語義層之間的橋樑，使你能夠：

• 通過自然語言對話直接查詢指標
• 瀏覽和搜索可用指標及其定義
• 使用維度分解和篩選器進行數據分析
• 在你的AI助手界面中可視化結果

故障排除

遇到問題時：

• 驗證API憑證是否正確
• 確保你的dbt Cloud項目已啟用語義層
• 檢查指標在你的dbt項目中是否定義正確

📄 許可證

該項目在MIT許可證下發布 - 有關詳細信息，請參閱LICENSE文件。

致謝

• dbt Labs 創建了dbt語義層
• Smithery 提供MCP部署平臺
• LiteMCP 提供MCP開發包