版本 2.0 – 主要版本 – 带来高级数据访问和管理的新功能
想象一下,不仅询问您的 ThingsBoard 平台问题,例如“显示过去一小时内报告离线的所有网关”或“列出设备 X 的警报及其严重性”(就像我们在 1.0版),但现在还可以跨实体运行复杂的查询,写入或更新设备、资产、警报、用户等——所有这些都通过统一的协议进行。借助 ThingsBoard MCP 2.0,这一愿景成为现实。
2.0 的新内容
我们在这个主要版本中突破了极限,有两大主题: 扩展数据查询能力, 和完整的写操作支持 跨关键实体类型。最重要的是,我们还解决了重要的错误修复,以提高可靠性。
主要特点
实体数据查询工具
- 您现在可以运行 复杂查询 覆盖实体、其字段、属性和遥测,并检索结构化数据集以进行高级分析工作流程。
- 无论您是跨设备、资产、客户、关系还是用户实体进行查找,新的查询工具都可以让您过滤、联接、聚合和提取所需的数据。
- 非常适合数据科学家、分析工程师和任何构建超越简单遥测查找的报告或仪表板的人。
写操作支持
我们在广泛的实体类型中添加了完整的写入功能(创建/更新/删除):
- 设备
- 资产
- 警报
- 顾客
- 关系
- 用户
- 实体组(PE 工具)
现在,您不仅可以查询 IoT 环境中发生的情况,还可以通过 MCP 接口以编程方式对其进行操作。这是迈向端到端自动化、自助服务操作和人工智能驱动的工作流程的真正一步。
小修复和改进
- 修复了“获取遥测”工具,以便在使用聚合函数时正确获取值 - 确保平均值、总和、最小/最大或自定义聚合操作现在返回预期数据。
- 核心 MCP 模块的其他稳定性和性能增强(内部管理、改进的日志记录、更好的错误消息)使 2.0 版成为一个强大的平台。
为什么这很重要
在 1.0 版本中,ThingsBoard MCP 为用户提供了对设备、遥测、属性和关系的对话式、人工智能辅助友好访问。 ThingsBoard MCP 2.0 版本实现了下一个飞跃:
- 更深入的分析:新的查询工具使您能够将 IoT 平台视为丰富的数据源,而不仅仅是遥测存储库。您可以请求跨实体的见解、复杂的属性/字段过滤器、聚合的遥测结果等。
- 可操作的工作流程:通过跨设备、资产、警报、用户等的写入支持,您不仅可以读取数据,还可以控制和管理您的环境。这就是自动化、编排和人工智能支持的操作的解锁。
- 减少开发开销:ThingsBoard MCP 2.0 提供了一个统一的抽象层,而不是构建定制的 API 或中间件来处理查询和写入。开发人员、数据工程师和非技术用户都会受益。
入门
以下是升级和解锁新功能的方法:
- 升级您的 MCP 服务器 – 从官方存储库中提取或构建 2.0 版映像(或 JAR)。
- 检查您的配置 – 确保您的 MCP 配置(例如,在 Claude Desktop 或其他 LLM 工具集成中)指向刷新的端点。如果您使用写入功能,请相应地检查并调整您的权限/安全设置。
- 探索查询工具 – 使用新的查询 API 运行实体数据查询。尝试按多个属性过滤设备,将资产与遥测连接,或按实体名称、设备类型和属性值的组合过滤设备。
- 测试写入操作 – 尝试通过 MCP 界面创建或更新设备、资产或警报。验证您可以根据需要操作关系和实体组。
版本 2.0 的完整参考文档(查询语法、写入 API 端点、权限模型、示例)可在 GitHub 存储库.
重点用例
以下是 MCP 2.0 开辟新可能性的一些现实场景:
- 预测性维护分析:运行查询以获取位置“Site-A”中振动遥测显示增加趋势的所有“泵”类型设备,然后为这些设备创建维护工作订单(通过写入操作)。
- 大规模设备上线:使用写入工具批量创建或更新设备、将它们分配给客户或资产、设置它们的关系和初始属性 - 所有这些都通过 MCP 而不是手动 UI 或 REST API 脚本。
- 自动报警处理:查询高于特定严重性阈值的所有活动警报,更新其状态,触发通知或升级给客户客户经理 - 从“提出问题”到“执行操作”无缝衔接。
- 面向非开发用户的自助分析:业务分析师可以使用查询工具提取跨客户的资产使用指标数据集,下载结果并输入到他们的 BI 工具中,而无需编写 SQL 或自定义 API 代码。
谢谢
我们要感谢我们的社区和早期采用者提供的宝贵反馈。您的用例、错误报告和功能请求有助于制定 MCP 的路线图。
请尝试 ThingsBoard MCP 2.0,报告任何问题,并与我们分享您的自动化和分析成功故事。
立即开始 — 访问 GitHub 存储库 并查看 2.0 版本的发行说明。让我们让您的 ThingsBoard IoT 平台更具对话性、可操作性和智能性!