ThingsBoard MCP Server 是 ThingsBoard 官方开发的 MCP（Model Context Protocol）服务器，用于将 AI 智能体连接到 ThingsBoard IoT 平台。其核心目的是让用户通过自然语言与物联网平台交互，完成设备查询、实体管理、遥测数据分析和运维自动化等任务。
主要能力方面，该服务器与 Claude Desktop、Cursor、VS Code Copilot、Claude Code 以及任何兼容 MCP 的客户端配合使用。它提供超过 120 个工具，分布在 10 个工具组中：设备（创建、更新、删除、列出、按名称/类型/组搜索）、资产（CRUD、按租户/客户列出、搜索）、客户（CRUD、列出、按标题搜索）、用户（CRUD、列出、管理员/客户用户管理）、告警（创建、确认、清除、删除、按严重程度查询）、遥测（读写属性和时间序列、聚合、TTL）、关系（创建、删除、导航实体关系）、OTA 包（上传、下载、将固件/软件分配给设备）、实体组（PE，管理组、分配/移除实体）以及实体数据查询（跨所有实体类型进行复杂过滤查询，支持属性/遥测过滤器）。此外还提供计数实体和帮助 LLM 构建正确查询的文档工具。
使用方式上，用户需要一个 ThingsBoard 实例（Cloud、EU Cloud、自托管 CE/PE 或 Edge）以及 API key（ThingsBoard 4.3+）或用户名/密码。对于 Claude Desktop，需在 claude_desktop_config.json 中添加配置；对于 Cursor，添加到 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目）；对于 VS Code，添加到 settings.json 或 .vscode/mcp.json。启动服务器后，将 MCP 客户端指向 http://localhost:8000/sse。如果 ThingsBoard 版本低于 4.3，需使用 THINGSBOARD_USERNAME 和 THINGSBOARD_PASSWORD 代替 THINGSBOARD_API_KEY。部署方式包括 Docker（推荐，支持 STDIO 默认模式和 SSE 模式）、下载二进制 JAR 或从源码构建（需要 Java 17+ 和 Maven 3.6+）。
适用场景包括：通过自然语言快速查询和管理 IoT 设备与资产；分析遥测数据并执行聚合查询；自动化告警管理和 OTA 固件/软件分发；在 AI 编程助手或桌面客户端中直接操作 ThingsBoard 平台。
限制方面，资料提到服务器暴露的 120+ 工具可能超出某些客户端的上下文限制，用户可以通过环境变量禁用不需要的工具组（例如将工具减少到约 50 个以适应上下文有限的客户端）。项目采用 Apache License 2.0 许可，并包含行为准则和安全政策。具体环境变量名称、完整配置示例和详细使用步骤在资料中未完全展开，暂未提供。
