dbt Semantic Layer MCP Server

一个用于通过 Claude Desktop 和其他兼容的 AI 助手无缝查询 dbt Semantic Layer 的 Model-Connector-Presenter (MCP) 服务器。

什么是 dbt Semantic Layer？

dbt Semantic Layer 是一个强大的功能，允许你在 dbt 项目中一次性定义指标，并在整个数据堆栈中一致地重用它们。它提供了：

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

关于本项目

此 MCP 服务器充当 AI 助手（如 Claude）和 dbt Semantic Layer 之间的桥梁，使你可以：

• 通过自然语言对话直接查询指标
• 浏览可用指标及其定义
• 使用维度分解和过滤器分析数据
• 在你的 AI 助手界面中可视化结果

功能

• 🔍 指标发现：浏览和搜索你 dbt Semantic Layer 中的可用指标
• 📊 查询创建：通过自然语言生成并执行语义查询
• 🧮 数据分析：过滤、分组和排序指标以获得更深入的见解
• 📈 结果可视化：以易于理解的格式显示查询结果

先决条件

• 启用了 Semantic Layer 的 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 Semantic Layer 进行交互：

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

故障排除

如果遇到问题：

• 验证你的 API 凭据是否正确
• 确保你的 dbt Cloud 项目已启用 Semantic Layer
• 检查你的指标是否在 dbt 项目中正确定义

贡献

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

许可证

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

致谢

• dbt Labs 创建了 dbt Semantic Layer
• Smithery 提供了 MCP 部署平台
• LiteMCP 提供了 MCP 开发包