dbt 语义层 MCP 服务器

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

什么是 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 语义层交互：

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

故障排除

如果遇到问题：

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

贡献

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

许可证

本项目根据 MIT 许可证发布 - 详情请参阅 LICENSE 文件。

致谢

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