dbt-docs-mcp

模型上下文协议 (MCP) 服务器，用于与 dbt 项目元数据（包括 dbt Docs 工件（ manifest.json 、 catalog.json ））交互。此服务器公开 dbt 图信息，并允许查询节点详细信息、模型/列沿袭以及相关元数据。

主要功能

该服务器提供以下工具：

• 搜索 dbt 节点：

  • 按名称 ( search_dbt_node_names ) 查找节点（模型、源、测试等）。

  • 根据列名 ( search_dbt_column_names ) 定位节点。

  • 在节点的已编译 SQL 代码中搜索（ search_dbt_sql_code ）。

• 检查节点：

  • 检索任何给定节点唯一 ID 的详细属性 ( 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 环境，例如：GXP2

   • 使用提供的脚本scripts/create_manifest_cl.py并简单地提供 dbt 清单、dbt 目录的路径以及架构和列沿袭文件的所需输出路径：GXP3

   • 根据您的 dbt 项目大小，创建列沿袭可能需要一段时间（数小时）

4. 运行服务器：

   • 如果您所需的 MCP 客户端（Claude 桌面、Cursor 等）支持 mcp.json，它将如下所示：GXP4