使用说明
dbt语义层MCP服务器
模型连接器演示器（MCP）服务器，用于通过Claude Desktop和其他兼容的AI助手无缝查询dbt语义层。
什么是dbt语义层？
这 dbt语义层 是一个强大的功能，允许您在dbt项目中定义一次指标，并在整个数据栈中一致地重用它们。它提供：
- 业务指标的单一真实来源
- 所有数据工具的一致度量定义
- 简化所有团队成员对复杂指标的访问
关于本项目
此MCP服务器充当AI助手（如Claude）和dbt语义层之间的桥梁，使您能够：
- 直接通过自然语言对话查询指标
- 探索可用的指标及其定义
- 使用维度细分和过滤器分析数据
- 在AI助手界面中可视化结果
特性
- 🔍 度量发现：浏览和搜索dbt语义层中的可用指标
- 📊 查询创建：通过自然语言生成和执行语义查询
- 🧮 数据分析：过滤、分组和排序指标，以获得更深入的见解
- 📈 结果可视化：以易于理解的格式显示查询结果
先决条件
- 启用语义层的dbt Cloud帐户
- API访问您的dbt云实例
- Node.js（v14或更高版本）
安装
史密斯路（推荐）
最简单的安装方法是通过 史密瑟里:
npx -y @smithery/cli install @TommyBez/dbt-semantic-layer-mcp --client claude
用法
安装和配置后，您可以直接从Claude Desktop与dbt语义层交互：
- 询问可用指标：“我的dbt语义层中有哪些可用指标？”
- 查询特定指标：“按产品类别显示上一季度的月度收入”
- 分析趋势：“用户注册的周增长率是多少？”
故障排除
如果您遇到问题：
- 验证您的API凭据是否正确
- 确保您的dbt Cloud项目启用了语义层
- 检查dbt项目中是否正确定义了指标
贡献
欢迎投稿！请随时提交拉取请求。
许可证
此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。
