dbt-mcp

让 AI 直接读懂你的 dbt 项目,写 SQL 不再靠猜

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 智能体 🍴 复刻 146 🐛 待处理 52 👀 关注 12
GitHub ↗
GitHub 星标 ★ 615
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费,需自行部署

项目预览

dbt-mcp 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类智能体
开发团队dbt-labs
定价模式🏷️完全免费
价格说明开源免费,需自行部署
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议Apache-2.0
主要语言Python
技术栈/模型data-analytics,data-engineering,dbt,llm,mcp,mcp-server,model-context-protocol
GitHub 星标★ 615
上线时间2025-03-12 00:00:00
代码更新2026-10-30
仓库体积8.2 MB
本站数据更新2026-11-02
维护状态活跃
收录时间2026-09-16
浏览次数1

项目介绍

dbt-mcp 是 dbt Labs 官方推出的 Model Context Protocol(MCP)服务器,用 Python 编写。它把 dbt 项目里的元数据、模型、宏、运行结果等能力封装成标准 MCP 工具,让 Claude、Cursor 等支持 MCP 的 AI 客户端可以直接查询和操作 dbt 项目。解决的问题是:以往 AI 助手不了解用户的 dbt 数据仓库结构,只能靠人工粘贴 schema 或 SQL,容易产生幻觉;dbt-mcp 让 AI 能实时读取项目上下文,从而生成更准确的 SQL、解释模型依赖、排查运行错误。核心能力包括:暴露 dbt 项目信息(模型、源、宏、指标)、触发 dbt 命令并返回结果、提供语义层查询接口,使 AI 代理可以完成数据探索、文档问答和调试等任务。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-09-16 · 当前星标 ★ 615

使用教程

难度:进阶 约 25 分钟 部署方式:本地安装 4 步

环境要求

  • 已有项目工程
  • 支持工具协议的助手

安装与启动步骤

  1. 1装成工具服务

    它是给助手用的服务端,装好后配到助手那边。

  2. 2配连接信息

    本地项目与服务端项目的填法不同,先确认你用的是哪种。

  3. 3试三个高频动作

    查模型清单、读字段描述、跑一次编译,这三件最常用。

  4. 4限住可写范围

    生产项目上把写操作关掉,只留查询,避免助手改坏模型。

如何确认成功

助手能查出某张表的字段含义并解释口径,且写操作在生产项目上被拒绝

注意事项

  • 它把项目元数据喂给助手,解的是助手不懂你数据模型的问题。
  • 元数据质量决定效果,描述字段写不全就答不准。
  • 写权限一旦打开,助手有能力改动生产模型,务必分级。
  • 服务端与本地工程的鉴权方式不同,配置别混。

核心亮点

  • 由 dbt Labs 官方维护,与 dbt 生态兼容性有保障
  • 把 dbt 项目元数据和命令封装成标准 MCP 工具,AI 客户端即插即用
  • 支持模型、宏、指标等语义层信息,能显著减少 AI 生成 SQL 时的幻觉

不足之处

  • 项目处于早期,功能覆盖和稳定性仍在迭代
  • 依赖支持 MCP 的客户端,使用门槛对非技术用户偏高

适用场景

  • 在 Claude/Cursor 中让 AI 基于真实 dbt 模型生成和解释 SQL
  • 数据工程师用自然语言排查 dbt 运行报错和依赖关系
  • 数据分析师通过 AI 问答快速了解 dbt 项目里的指标口径

替代项目

mcp-server-sqlite、postgres-mcp

上一篇:Agent

下一篇:MASCOT

同类项目推荐

Cyrene-Agent 开源

桌面常驻人格 AI,陪聊同时帮你干活写代码

一款开源、基于昔涟开发的桌面 AI 智能体/An open-source desktop AI agent based on Cyre···

★ 774 2026-09-22
SecurityClaw 开源

让 LLM 自动盯日志、查异常,安全告警秒级响应

A modular, skill-based autonomous Security Operations Center (SOC) agent that monito···

★ 278 2026-08-09
openagentskill 开源

像装 npm 包一样安装 AI 技能,让智能体能力即插即用。

The skill layer for AI agents: npm for AI Agent Skills.

★ 366 2026-08-09
codebuddy 开源

让 AI 自主写代码,你只管提需求

An Autonomous AI Software Engineer

★ 142 2026-08-09
MasterAgent 开源

设备本地跑 AI 智能体,百毫秒响应不联网

Build AI agents that run 100% on-device. Sub-100ms latency on Qualcomm NPU. Zero clo···

★ 977 2026-09-25
Meldwork 开源

本地跑多智能体协作,权限可控、过程可查、关键处人工拍板

Local-first AI agent workspace for multi-agent collaboration, agent orchestration, s···

★ 1366 2026-10-19
awesome-saas 开源

用现成模板,快速搭建你的AI SaaS应用

Collection of templates using the Alchemyst AI Platform for your next big AI app.

★ 420 2026-08-09
cli 开源

让 AI 编程助手记住仓库历史,跨会话不迷路

Archived: Archcore moved to github.com/archcore-ai/archcore (CLI under cli/)

★ 66 2026-08-09
awesome-mcp-servers 开源

按场景找齐 MCP 服务器,智能体接工具不再翻遍 GitHub

A curated catalog of Model Context Protocol (MCP) servers for discovering and integr···

★ 189 2026-10-06