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"
            }
        }
    }
}