dbt Semantic Layer MCP 服务器

一个模型-连接器-展示器 (MCP) 服务器，用于通过 Claude Desktop 和其他兼容的 AI 助手无缝查询 dbt Semantic Layer。

什么是 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 开发包