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 查询的工具。
- 直接从数据库检索表/视图/列元数据的工具。
- 搜索知识库的工具。

**先决条件：**确保已安装 Python 和uv
克隆仓库：
git clone <repository-url> cd dbt-docs-mcp
可选：解析 dbt 清单以获取列级沿袭：
- 设置所需的 Python 环境，例如：GXP2
- 使用提供的脚本scripts/create_manifest_cl.py并简单地提供 dbt 清单、dbt 目录的路径以及架构和列沿袭文件的所需输出路径：GXP3
- 根据您的 dbt 项目大小，创建列沿袭可能需要一段时间（数小时）
运行服务器：
- 如果您所需的 MCP 客户端（Claude 桌面、Cursor 等）支持 mcp.json，它将如下所示：GXP4

pdf-tools-mcp