dbt-mcp

为AI智能体提供与dbt项目交互的工具集

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:dbt-mcp。
它的用途是:为AI智能体提供与dbt项目交互的工具集
完整的 Skill 内容见:https://321skill.com/skills/dbt-mcp/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“帮我分析一下最近一周的销售关键指标,并找出表现异常的区域模型。”,它会通过dbt-mcp调用`list_metrics`和`query_metrics`工具获取定义的销售指标和数据,然后使用`get_lineage`和`get_model_health`工具检查相关数据模型的血缘关系和健康状态,最终为你生成一份包含数据洞察和潜在问题模型的分析报告。

介绍

dbt-mcp是一个MCP服务器,它让AI智能体能够连接并操作你的dbt项目。它解决了AI在数据转换和分析任务中缺乏项目上下文的问题,通过提供一系列标准化工具,使AI能够理解你的数据模型、执行查询、分析语义层指标并探索项目结构。

使用时,你需要将dbt-mcp服务器配置到支持MCP协议的AI客户端(如Claude Desktop)中。配置完成后,AI助手便能直接调用工具来查询模型详情、执行SQL、获取指标数据或分析项目血缘关系,无需你手动在dbt环境中操作。

这个工具非常适合依赖dbt进行数据建模和分析的团队,特别是那些希望将AI深度集成到数据工作流中,以提升数据探索、问题排查和报告生成效率的角色。

建议在使用前确保你的dbt项目环境(无论是Core、Fusion还是Platform)已正确配置,并熟悉MCP客户端的配置方法。部分高级功能(如执行SQL)可能需要相应的dbt Platform权限。

核心特点

这是由dbt官方维护的MCP服务器,深度集成了dbt Core、Fusion和Platform的全部能力,提供了从SQL执行、语义层查询到项目发现的一站式工具,而非仅提供基础的项目信息读取。

注意事项

不适合不熟悉dbt或MCP协议配置流程的用户,且部分高级功能依赖于dbt Platform的订阅权限。

常见问题

dbt-mcp支持哪些dbt版本?

支持dbt Core、dbt Fusion和dbt Platform,具体兼容性请参考官方文档。

如何将dbt-mcp配置到Claude Desktop中?

按照dbt官方文档或MCP客户端指南,在Claude Desktop配置文件中添加dbt-mcp服务器的路径或MCP Bundle即可。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/dbt-mcp/raw/index.md 读取 dbt-mcp 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。