mcp/thingsboard Docker Image Overview

mcp/thingsboard

通过MCP服务器连接AI工作流与ThingsBoard IoT平台，支持大型语言模型（LLM）以自然语言查询设备遥测数据、管理IoT实体（设备、资产、客户）和分析传感器数据，适用于构建AI驱动的IoT监控、预测性维护和自动化设备管理工作流，兼容ThingsBoard社区版和专业版。

0 次下载

🚀 生产环境还在裸拉官方镜像？一次故障=一次通宵

中文简介版本下载

🚀 生产环境还在裸拉官方镜像？一次故障=一次通宵

ThingsBoard MCP服务器

镜像概述和主要用途

ThingsBoard MCP服务器用于连接AI工作流与ThingsBoard IoT平台，使大型语言模型（LLM）能够通过自然语言查询设备遥测数据、管理IoT实体（设备、资产、客户）和分析传感器数据。该镜像适用于构建AI驱动的IoT监控、预测性维护和自动化设备管理工作流，同时支持ThingsBoard社区版和专业版。

什么是MCP服务器？

MCP信息

属性	详情
Docker镜像	mcp/thingsboard
作者	thingsboard
代码仓库	[***]

镜像构建信息

属性	详情
Dockerfile	[***]
Docker镜像构建者	Docker Inc.
Docker Scout健康评分	!Docker Scout Health Score
验证签名	`COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/thingsboard --key [***]`
许可证	Apache License 2.0

可用工具（62个）

服务器提供的工具	简短描述
`findByFrom`	返回指定实体在“from”方向的关系对象列表。
`findByFromWithRelationType`	返回指定实体在“from”方向和特定关系类型的关系对象列表。
`findByTo`	返回指定实体在“to”方向的关系对象列表。
`findByToWithRelationType`	返回指定实体在“to”方向和特定关系类型的关系对象列表。
`findInfoByFrom`	返回指定实体在“from”方向的关系信息对象列表。
`findInfoByTo`	返回指定实体在“to”方向的关系信息对象列表。
`getAdminSettings`	使用指定字符串键获取管理设置对象。
`getAlarmById`	根据提供的告警ID获取告警对象。
`getAlarmInfoById`	根据提供的告警ID获取告警信息对象。
`getAlarmTypes`	获取基于租户拥有或用户所属客户分配的告警的唯一告警类型集合。
`getAlarms`	获取所选实体的告警分页数据。
`getAllAlarms`	获取当前用户所有者的告警分页数据。
`getAllCustomerUsers`	返回当前租户中具有“CUSTOMER_USER”权限的用户分页数据。
`getAssetById`	根据提供的资产ID获取资产对象。
`getAssetsByEntityGroupId`	返回属于指定实体组ID的资产对象分页数据。
`getAssetsByIds`	通过ID列表获取资产。
`getAttributeKeys`	返回所选实体的唯一属性键名集合。
`getAttributeKeysByScope`	返回所选实体和指定属性作用域的唯一属性键名集合。
`getAttributes`	返回指定实体的所有属性。
`getAttributesByScope`	返回指定实体的指定作用域的所有属性。
`getCustomerAssets`	返回分配给客户的资产对象分页数据。
`getCustomerById`	根据提供的客户ID获取客户对象。
`getCustomerDevices`	返回分配给客户的设备对象分页数据。
`getCustomerUsers`	返回分配给指定客户的用户分页数据。
`getCustomers`	返回租户拥有的客户分页数据。
`getCustomersByEntityGroupId`	返回属于指定实体组ID的客户对象分页数据。
`getDeviceById`	根据提供的设备ID获取设备对象。
`getDeviceCredentialsByDeviceId`	通过设备ID获取设备凭证。
`getDevicesByEntityGroupId`	返回属于指定实体组ID的设备对象分页数据。
`getDevicesByIds`	通过ID列表获取设备。
`getEntityGroupById`	根据提供的实体组ID获取实体组对象。
`getEntityGroupByOwnerAndNameAndType`	根据提供的所有者、类型和名称获取实体组对象。
`getEntityGroupsByIds`	根据提供的实体组ID列表获取实体组信息对象列表。
`getEntityGroupsByOwnerAndType`	根据提供的所有者ID和实体类型获取实体组信息对象列表。
`getEntityGroupsByType`	根据提供的实体类型获取实体组信息对象列表。
`getEntityGroupsForEntity`	返回包含指定实体ID的组列表。
`getHighestAlarmSeverity`	根据发起者（“entityType”和“entityId”）以及可选的“status”和“searchStatus”筛选条件获取最高告警级别。
`getLatestTimeseries`	返回指定实体的所有最新时序数据。
`getRelation`	返回两个指定实体之间的关系对象（如果存在）。
`getSecuritySettings`	获取包含密码策略、锁定限制、通知电子邮件、移动密钥长度以及激活和密码重置令牌TTL值（1-24小时）的安全设置对象。
`getSystemInfo`	获取系统主要信息。
`getTenantAdmins`	返回分配给指定租户的租户管理员用户分页数据。
`getTenantAsset`	获取租户资产。
`getTenantAssets`	返回租户拥有的资产分页数据。
`getTenantCustomer`	使用客户标题获取客户。
`getTenantDevice`	获取用户所属租户拥有的设备。
`getTenantDevices`	返回租户拥有的设备分页数据。
`getTimeseries`	返回指定实体的时序值范围数据。
`getTimeseriesKeys`	返回所选实体的唯一时序键名集合。
`getUsageInfo`	检索当前租户的使用统计信息，包括设备、资产、客户、用户、仪表板、边缘、传输消息等数量。
`getUserAssets`	返回当前用户可用的资产对象分页数据。
`getUserById`	根据提供的用户ID获取用户对象。
`getUserCustomers`	返回用户可用的客户分页数据。
`getUserDevices`	返回当前用户可用的设备对象分页数据。
`getUsers`	返回租户或客户拥有的用户分页数据。
`getUsersByEntityGroupId`	返回属于指定实体组ID的用户对象分页数据。
`getUsersForAssign`	返回可分配给指定告警ID的用户数据对象分页数据。
`saveDeviceAttributes`	基于设备ID和指定属性作用域创建或更新设备属性。
`saveEntityAttributesV1`	基于实体ID和指定属性作用域创建或更新实体属性（V1版本）。
`saveEntityAttributesV2`	基于实体ID和指定属性作用域创建或更新实体属性（V2版本）。
`saveEntityTelemetry`	基于实体ID和请求负载创建或更新实体时序数据。
`saveEntityTelemetryWithTTL`	基于实体ID和请求负载创建或更新带TTL的实体时序数据。

工具详情

工具：`findByFrom`

返回指定实体在“from”方向的关系对象列表。

若用户具有“系统管理员”权限，服务器会检查“from”和“to”实体是否归系统管理员所有；若用户具有“租户管理员”权限，服务器会检查“from”和“to”实体是否归同一租户所有；若用户具有“客户用户”权限，服务器会检查“from”和“to”实体是否分配给同一客户。

参数	类型	描述
`strFromId`	`string`	表示实体ID的字符串值，例如：'784f394c-42b6-435a-983c-b7beff2784f9'
`strFromType`	`string`	表示实体类型的字符串值，例如：'DEVICE'
`strRelationTypeGroup`	`string` 可选	表示关系类型组的字符串值，例如：'COMMON'

工具：`findByFromWithRelationType`

返回指定实体在“from”方向和特定关系类型的关系对象列表。

参数	类型	描述
`relationType`	`string`	表示实体间关系类型的字符串值，例如：'Contains'、'Manages'，可为任意字符串值
`strFromId`	`string`	表示实体ID的字符串值，例如：'784f394c-42b6-435a-983c-b7beff2784f9'
`strFromType`	`string`	表示实体类型的字符串值，例如：'DEVICE'
`strRelationTypeGroup`	`string` 可选	表示关系类型组的字符串值，例如：'COMMON'

工具：`findByTo`

返回指定实体在“to”方向的关系对象列表。

参数	类型	描述
`strToId`	`string`	表示实体ID的字符串值，例如：'784f394c-42b6-435a-983c-b7beff2784f9'
`strToType`	`string`	表示实体类型的字符串值，例如：'DEVICE'
`strRelationTypeGroup`	`string` 可选	表示关系类型组的字符串值，例如：'COMMON'

工具：`findByToWithRelationType`

返回指定实体在“to”方向和特定关系类型的关系对象列表。

参数	类型	描述
`relationType`	`string`	表示实体间关系类型的字符串值，例如：'Contains'、'Manages'，可为任意字符串值
`strToId`	`string`	表示实体ID的字符串值，例如：'784f394c-42b6-435a-983c-b7beff2784f9'
`strToType`	`string`	表示实体类型的字符串值，例如：'DEVICE'
`strRelationTypeGroup`	`string` 可选	表示关系类型组的字符串值，例如：'COMMON'

工具：`findInfoByFrom`

返回指定实体在“from”方向的关系信息对象列表。

若用户具有“系统管理员”权限，服务器会检查“from”和“to”实体是否归系统管理员所有；若用户具有“租户管理员”权限，服务器会检查“from”和“to”实体是否归同一租户所有；若用户具有“客户用户”权限，服务器会检查“from”和“to”实体是否分配给同一客户。关系信息是默认关系对象的扩展，包含“from”和“to”实体名称信息。

参数	类型	描述
`strFromId`	`string`	表示实体ID的字符串值，例如：'784f394c-42b6-435a-983c-b7beff2784f9'
`strFromType`	`string`	表示实体类型的字符串值，例如：'DEVICE'
`strRelationTypeGroup`	`string` 可选	表示关系类型组的字符串值，例如：'COMMON'

工具：`findInfoByTo`

返回指定实体在“to”方向的关系信息对象列表。

参数	类型	描述
`strToId`	`string`	表示实体ID的字符串值，例如：'784f394c-42b6-435a-983c-b7beff2784f9'
`strToType`	`string`	表示实体类型的字符串值，例如：'DEVICE'
`strRelationTypeGroup`	`string` 可选	表示关系类型组的字符串值，例如：'COMMON'

工具：`getAdminSettings`

使用指定字符串键获取管理设置对象。引用不存在的键将导致错误。

仅适用于具有“SYS_ADMIN”权限的用户。

参数	类型	描述
`key`	`string`	键的字符串值（例如：'general'、'mail'、'notifications'、'sms'、'entitiesVersionControl'、'connectivity'、'jwt'等）

工具：`getAlarmById`

根据提供的告警ID获取告警对象。若用户具有“租户管理员”权限，服务器会检查告警发起者是否归同一租户所有；若用户具有“客户用户”权限，服务器会检查告警发起者是否属于该客户。

参数	类型	描述
`alarmId`	`string`	表示告警ID的字符串值，例如：'784f394c-42b6-435a-983c-b7beff2784f9'

工具：`getAlarmInfoById`

根据提供的告警ID获取告警信息对象。若用户具有“租户管理员”权限，服务器会检查告警发起者是否归同一租户所有；若用户具有“客户用户”权限，服务器会检查告警发起者是否属于该客户。告警信息是默认告警对象的扩展，还包含告警发起者名称。

适用于具有“TENANT_ADMIN”或“CUSTOMER_USER”权限的用户。

参数	类型	描述
`alarmId`	`string`	表示告警ID的字符串值，例如：'784f394c-42b6-435a-983c-b7beff2784f9'

工具：`getAlarmTypes`

获取基于租户拥有或用户所属客户分配的告警的唯一告警类型集合。

适用于具有“TENANT_ADMIN”或“CUSTOMER_USER”权限的用户。

参数	类型	描述
`page`	`integer`	页码，从0开始
`pageSize`	`integer`	每页最大实体数量
`sortOrder`	`string` 可选	排序顺序，ASC（升序）或DESC（降序）
`textSearch`	`string` 可选	基于告警字段（类型、级别或状态）的不区分大小写的“子字符串”筛选