dbt Semantic Layer MCP Server

Name: dbt Semantic Layer MCP Server
Author: TommyBez

本地服务

github.com/TommyBez记忆与知识1186 周前更新

代码仓库

关于 dbt Semantic Layer MCP Server

dbt Semantic Layer MCP Server 将 AI 助手连接到 dbt Semantic Layer，供团队以自然语言查询已定义的指标。它也支持指标发现、维度分析和结果展示。

主要功能

01浏览和搜索指标
02通过自然语言创建查询
03筛选、分组和排序数据
04展示查询结果

适用场景

01查看可用业务指标
02按产品类别分析月度收入
03分析用户注册增长趋势

MCP 相关

该 MCP 服务连接 dbt Semantic Layer，向兼容的 AI 助手提供指标发现、查询和分析能力。

#dbt #semantic-layer #mcp-server

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "dbt-semantic-layer": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}

启动命令npx -y @smithery/cli

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@smithery/clistdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

dbt 语义层 MCP 服务

一个 Model-Connector-Presenter（MCP）服务，可通过 Claude Desktop 和其他兼容的 AI 助手无缝查询 dbt 语义层。

什么是 dbt 语义层？

dbt 语义层是一项强大功能，可让你在 dbt 项目中定义一次指标，并在整个数据技术栈中一致地重复使用。它提供：

业务指标的单一事实来源
所有数据工具中一致的指标定义
为所有团队成员简化复杂指标的访问方式

关于此项目

此 MCP 服务充当 AI 助手（如 Claude）与 dbt 语义层之间的桥梁，让你能够：

通过自然语言对话直接查询指标
探索可用指标及其定义
使用维度拆分和筛选条件分析数据
在 AI 助手界面中可视化结果

功能

🔍 指标发现：浏览和搜索 dbt 语义层中的可用指标
📊 查询创建：通过自然语言生成并执行语义查询
🧮 数据分析：筛选、分组和排序指标，以获取更深入的洞察
📈 结果可视化：以易于理解的格式展示查询结果

前提条件

已启用语义层的 dbt Cloud 账户
对 dbt Cloud 实例的 API 访问权限
Node.js（v14 或更高版本）

安装

通过 Smithery 安装（推荐）

最简单的安装方式是通过 Smithery：

npx -y @smithery/cli install @TommyBez/dbt-semantic-layer-mcp --client claude

使用方法

安装并配置完成后，你可以直接在 Claude Desktop 中与 dbt 语义层交互：

询问可用指标：“我的 dbt 语义层中有哪些可用指标？”
查询特定指标：“显示上一季度按产品类别分组的月度收入”
分析趋势：“用户注册量的周环比增长是多少？”

故障排除

如果遇到问题：

确认 API 凭据正确
确保 dbt Cloud 项目已启用语义层
检查 dbt 项目中的指标是否定义正确

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

此项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。

致谢

感谢 dbt Labs 创建 dbt 语义层
感谢 Smithery 提供 MCP 部署平台
感谢 LiteMCP 提供 MCP 开发包

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。