dbt 文档 MCP 服务器

模型上下文协议（MCP）服务器用于与 dbt 项目元数据交互，包括 dbt Docs 文本资产（manifest.json、catalog.json）。该服务器提供 dbt 图信息，并允许查询节点详细信息、模型/列血缘关系及相关元数据。

关键功能

此服务器提供了以下工具：

• 搜索 dbt 节点：

  • 根据名称查找节点（模型、来源、测试等）（search_dbt_node_names）。
  • 根据列名定位节点（search_dbt_column_names）。
  • 在节点的编译 SQL 代码中搜索（search_dbt_sql_code）。

• 查看节点：

  • 获取任何给定节点唯一标识符的详细属性（get_dbt_node_attributes）。

• 探索血缘关系：

  • 查找节点的直接上游依赖项（前驱）（get_dbt_predecessors）。
  • 查找节点的直接下游依赖项（后置）（get_dbt_successors）。

• 列级血缘关系：

  • 追踪模型中特定列的所有上游来源（get_column_ancestors）。
  • 追踪模型中特定列的所有下游依赖项（get_column_descendants）。

• 建议扩展：

  • 执行 SQL 查询的工具。
  • 直接从数据库获取表/视图/列元数据的工具。
  • 搜索知识库的工具。

快速入门

1. 先决条件： 确保安装了 Python 并且有 uv。
2. 克隆仓库：

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

3. 可选：解析 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 项目规模，生成列血缘关系可能需要一段时间（数小时）。
4. 运行服务器：
   • 如果您的目标 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"
           }
           }
       }
   }