由 Site Kit 添加的 Google 跟踪代码管理器 (noscript) 代码段 结束 Site Kit 添加的 Google 跟踪代码管理器 (noscript) 代码段
ThingsBoard MCP 简介 ThingsBoard MCP 简介

ThingsBoard MCP 简介:自然语言访问您的物联网平台

与 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,看看物联网数据探索是多么轻松。

👉 GitHub 上的 ThingsBoard MCP 入门