Dbt Docs MCP

🚀 dbt 文檔 MCP 服務器

模型上下文協議（MCP）服務器用於與 dbt 項目元數據進行交互，這些元數據包含 dbt Docs 文本資產（如 manifest.json、catalog.json）。該服務器不僅能提供 dbt 圖信息，還支持查詢節點詳細信息、模型/列血緣關係以及相關元數據。

✨ 主要特性

此服務器提供了以下實用工具：

• 搜索 dbt 節點：
  • search_dbt_node_names：可根據名稱查找節點，涵蓋模型、來源、測試等。
  • search_dbt_column_names：依據列名定位節點。
  • search_dbt_sql_code：能在節點的編譯 SQL 代碼中進行搜索。
• 查看節點：
  • get_dbt_node_attributes：獲取任何給定節點唯一標識符的詳細屬性。
• 探索血緣關係：
  • get_dbt_predecessors：查找節點的直接上游依賴項（前驅）。
  • get_dbt_successors：查找節點的直接下游依賴項（後置）。
• 列級血緣關係：
  • get_column_ancestors：追蹤模型中特定列的所有上游來源。
  • get_column_descendants：追蹤模型中特定列的所有下游依賴項。
• 建議擴展：
  • 執行 SQL 查詢的工具。
  • 直接從數據庫獲取表/視圖/列元數據的工具。
  • 搜索知識庫的工具。

🚀 快速開始

先決條件

確保已經安裝了 Python 並且有 uv。

克隆倉庫

git clone <repository-url>
cd dbt-docs-mcp

可選：解析 dbt 說明文件以獲取列級血緣關係

• 設置所需的 Python 環境，例如：

uv sync

• 使用提供的腳本 scripts/create_manifest_cl.py，並提供 dbt 說明文件、dbt 目錄和所需輸出路徑的 schema 映射和說明 CL 文件：

python scripts/create_manifest_cl.py --manifest-path PATH_TO_YOUR_MANIFEST_FILE --catalog-path PATH_TO_YOUR_CATALOG_FILE --schema-mapping-path DESIRED_OUTPUT_PATH_FOR_SCHEMA_MAPPING --manifest-cl-path DESIRED_OUTPUT_PATH_FOR_MANIFEST_CL

• ⚠️ 重要提示：根據您的 dbt 項目規模，生成列血緣關係可能需要一段時間（數小時）。

運行服務器

如果您的目標 MCP 客戶端（Claude 桌面、Cursor 等）支持 mcp.json，則如下所示：

{
    "mcpServers": {
        "DBT 文檔 MCP": {
            "command": "uv",
            "args": [
                "run",
                "--with",
                "networkx,mcp[cli],rapidfuzz,dbt-core,python-decouple,sqlglot,tqdm",
                "mcp",
                "run",
                "/Users/mattijs/repos/dbt-docs-mcp/src/mcp_server.py"
            ],
            "env": {
                "MANIFEST_PATH": "/Users/mattijs/repos/dbt-docs-mcp/inputs/manifest.json",
                "SCHEMA_MAPPING_PATH": "/Users/mattijs/repos/dbt-docs-mcp/outputs/schema_mapping.json",
                "MANIFEST_CL_PATH": "/Users/mattijs/repos/dbt-docs-mcp/outputs/manifest_column_lineage.json"
            }
        }
    }
}