🚀 dbt语义层MCP服务器

一个用于通过Claude Desktop和其他兼容的AI助手无缝查询dbt语义层的Model-Connector-Presenter (MCP)服务器，让你能借助AI助手以自然语言便捷地与dbt语义层交互，获取所需数据。

🚀 快速开始

本MCP服务器能让你通过AI助手（如Claude）与dbt语义层建立连接，实现自然语言查询指标、浏览指标定义等功能。在开始前，你需要具备启用语义层的dbt Cloud账户、dbt Cloud实例的API访问权限以及Node.js（v14或更高版本）。

✨ 主要特性

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

📦 安装指南

通过Smithery（推荐）

最简单的安装方式是通过Smithery，使用以下命令进行安装：

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

💻 使用示例

基础用法

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

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

📚 详细文档

什么是dbt语义层？

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

• 指标事实的单一来源
• 数据工具之间一致的指标定义
• 简化复杂指标供所有团队成员使用

关于该项目

这个MCP服务器充当AI助手（如Claude）和dbt语义层之间的桥梁，使你能够：

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

故障排除

遇到问题时：

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

📄 许可证

该项目在MIT许可证下发布 - 有关详细信息，请参阅LICENSE文件。

致谢

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