dbt 语义层 MCP 服务器

这是一个模型-连接器-展示器（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 语义层进行交互：

1. 查询可用的指标："我的 dbt 语义层中有哪些可用的指标？"
2. 查询特定的指标："显示上个季度按产品类别分组的月度收入"
3. 分析趋势："每周用户注册的增长情况如何？"

故障排除

如果你遇到问题：

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

贡献

欢迎贡献！请随意提交拉取请求。

许可证

本项目采用 MIT 许可证 - 详情见 LICENSE 文件。

致谢

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