Dbt MCP Server

🚀 🛠️ dbt 模型控制協議（MCP）服務器

這是一個最小化、可擴展的 MCP（模型控制協議）服務器，可通過統一接口運行 dbt 模型，為你的 dbt 操作提供便捷、高效的解決方案。

如果你喜歡這個倉庫，請點個 ⭐️，你的支持對我們很重要！

🚀 快速開始

✅ 本項目已經準備好與 AI 工具（如 Claude）集成！

在本地運行（使用 UV）

uvicorn mcp_dispatcher:app --reload --port 8000

使用 Docker 運行

docker build -t dbt-mcp-server .
docker run -p 8000:8000 dbt-mcp-server

使用 Claude 觸發 MCP（支持的客戶端）

python claude_client_example.py

✨ 主要特性

• 使用乾淨的 JSON 規範運行 dbt 模型，讓操作更加簡潔明瞭。
• 支持 CLI 或 HTTP API 調用，滿足不同場景的使用需求。
• 提供模型狀態的 Slack 警告，及時掌握模型運行情況。
• 兼容 Claude 等 AI 工具，便於與先進技術集成。

📦 安裝指南

本項目提供了多種運行方式，你可以根據自己的需求選擇合適的方式進行安裝：

• 本地運行（使用 UV）：執行 uvicorn mcp_dispatcher:app --reload --port 8000 命令。
• 使用 Docker 運行：先執行 docker build -t dbt-mcp-server . 構建鏡像，再執行 docker run -p 8000:8000 dbt-mcp-server 運行容器。

💻 使用示例

基礎用法

通過以下命令使用：

python mcp_dispatcher.py mcp_request.json

配置示例

{
  "mcpServers": {
    "fetch": {
      "command": "node",
      "args": [
        "{ABSOLUTE PATH TO FILE HERE}/dist/index.js"
      ]
    }
  }
}

📣 Slack 警告

⚠️ 重要提示

設置 SLACK_WEBHOOK_URL，以在模型成功或失敗時接收警告。

🛠️ 貢獻指南

如果你有興趣貢獻代碼或想法，歡迎打開問題頁面發起討論或直接提交拉取請求。無論是代碼、建議還是反饋，所有貢獻都受到歡迎！

📄 許可證

此 MCP 服務器根據 MIT 許可證分發。這意味著你可以自由地使用、修改和分發軟件，但需遵守 MIT 許可證的條款和條件。更多詳細信息，請參閱項目倉庫中的 LICENSE 文件。