与 ThingsBoard 交互的新方式
想象一下能够简单地 问 您的物联网平台问题如下:
- “显示过去一小时内报告离线的所有网关”
- “今天从我的温度传感器获取超过 30°C 的遥测数据”
- “列出设备 X 的警报及其严重性”
没有 API 调用。没有 SQL 查询。只是自然语言。
随着新 ThingsBoard MCP(模型上下文协议)服务器,这一愿景成为现实。 MCP 充当 ThingsBoard 和 AI 助手之间的桥梁,例如 克劳德桌面,支持以自然语言访问设备、遥测、警报、属性和关系。
什么是 ThingsBoard MCP?
ThingsBoard MCP 服务器 是一个开源集成,它实现了 模型上下文协议 (MCP)。 MCP 旨在让 AI 系统(例如 Claude 或其他基于 LLM 的助手)以结构化、可靠的方式直接与外部工具和数据源交互。
借助 MCP,您可以:
- 查询 ThingsBoard 实体:设备、资产、客户、用户。
- 获取遥测数据和属性 用自然语言。
- 探索关系 实体之间。
- 监控和管理警报.
- 访问管理工具 例如系统信息或使用统计信息。
将 MCP 视为翻译器:它将自然语言请求映射到 ThingsBoard 操作并返回结构化、有意义的结果。
为什么它很重要
不带MCP
- 用户或开发人员必须与 REST API或者WebSocket API.
- 每个查询都需要样板代码、身份验证、分页、错误处理。
- 如果没有自定义包装器,人工智能助手就无法轻松使用该平台。

与MCP
- 你可以 以对话方式提问 通过克劳德桌面。
- 人工智能助手 理解上下文 并且可以获取遥测数据、分析趋势,甚至提出行动建议。
- 非技术用户获益 自助分析 无需学习API。

特点一览
- 实体工具 – 列出设备、获取详细信息、搜索资产或客户。
- 遥测工具 – 获取时间序列、聚合数据、插入新的遥测数据。
- 关系工具 – 导航“来自”和“至”实体关系。
- 报警工具 – 列出警报、获取严重性、按发起者或状态进行过滤。
- 管理工具 Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try again later.That’s all we know.
这些工具提供了人工智能助手可以直接使用的语义层,使 ThingsBoard 具有对话性和代理友好性。
Claude Desktop + Docker 入门
尝试 MCP 的最快方法是通过 克劳德桌面 与官方 MCP Docker 镜像。
第1步:安装克劳德桌面
- 下载自 人择 并安装在您的系统上。
- Claude Desktop 支持将 MCP 服务器配置为外部工具。
第 2 步:配置克劳德 MCP
创建或更新 Claude 的配置文件(claude_desktop_config.json)以包括 ThingsBoard MCP。
配置示例:
{
"mcpServers": {
"thingsboard": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"THINGSBOARD_URL",
"-e",
"THINGSBOARD_USERNAME",
"-e",
"THINGSBOARD_PASSWORD",
"-e",
"LOGGING_PATTERN_CONSOLE",
"thingsboard/mcp"
],
"env": {
"THINGSBOARD_URL": "<thingsboard_url>",
"THINGSBOARD_USERNAME": "<thingsboard_username>",
"THINGSBOARD_PASSWORD": "<thingsboard_password>",
"LOGGING_PATTERN_CONSOLE": ""
}
}
}
}
- 替换 <
thingsboard_url>, <thingsboard_username>, 和<thingsboard_password>用你自己的凭据。 - 每次 Claude Desktop 启动时,它都会自动启动 MCP 容器。
第 3 步:开始向 Claude 询问您的 IoT 数据
配置完成后,打开 Claude Desktop 并尝试自然语言提示,例如:
- “列出温度传感器类型的所有设备。”
- “获取 Sensor-123 设备最后一小时的遥测数据(温度、湿度)。”
- “显示今天发出的所有严重警报。”
Claude 将使用 MCP 查询 ThingsBoard 并返回基于 JSON 的结构化结果,而您无需编写单个 API 调用。
更高级的用法
MCP 服务器支持更多选项:
- 磨合中 SSE模式 用于网络集成。
- 使用 JAR 分发 而不是 Docker。
- 先进的 安全和管理工具.
👉 您可以在中找到完整的详细信息、高级用法和开发人员文档 ThingsBoard MCP GitHub 存储库.
使用案例
- 对话式仪表板 – 操作员直接提出问题,而不是浏览仪表板。
- 人工智能驱动的监控 – 代理自动分析遥测和警报。
- 更快的原型设计 – 在编码集成之前尝试使用自然语言进行查询。
- 自助分析 – 非开发人员无需 API 即可获取见解。
结论
和 ThingsBoard MCP,您的物联网平台将变成 对话式且人工智能友好.
无论您是操作员、工程师还是数据科学家,MCP 都可以实现自然语言交互、更快的洞察力和更轻松的原型设计。
立即尝试使用 Claude Desktop,看看物联网数据探索是多么轻松。