Repolode
提交项目
ThingsPanel

ThingsPanel/thingspanel-mcp

让 Claude、GPT 等 AI 助手通过 MCP 协议查询和控制 ThingsPanel 物联网平台设备及 ThingsVis 仪表盘的服务端。

在 GitHub 查看
Star
48
Fork
23
未关闭 Issue
2
最近提交
14天前

这是什么？

ThingsPanel MCP 是一个基于 Python 的服务端，把 ThingsPanel 与 ThingsVis 的 API 封装为 Model Context Protocol 工具，使兼容 MCP 的 AI 助手可以用自然语言处理物联网数据和设备。共提供 378 个工具：14 个面向设备、遥测、仪表盘和指令的常用工具，以及 364 个按接口逐一命名的工具，覆盖 312 个 ThingsPanel 接口和 52 个 ThingsVis 接口。

每个接口工具对应固定的 HTTP 方法与路由，调用时传入路径参数、查询参数、JSON 请求体或待上传文件。写入和控制类操作需要显式传入 confirmed=true，返回结果为结构化 JSON，并能识别业务错误码。凭据通过本地配置文件中的命名 profile 或环境变量管理，权限始终由后端服务校验。

默认使用 stdio 传输，也可选择 SSE，可通过 PyPI 或源码安装，并提供 Codex、Claude Desktop 和 WorkBuddy 的配置示例。

核心功能

  • 01提供 378 个 MCP 工具，覆盖设备、遥测、告警、仪表盘、产品和文件上传。
  • 02接口工具映射到固定且经过白名单校验的路由，不接受任意 URL。
  • 03写入和控制类操作在发送前必须传入 confirmed=true。
  • 04通过命名 profile 管理凭据，可切换不同的 ThingsPanel 或 ThingsVis 身份。
  • 05返回结构化 JSON 结果，并检查 ThingsPanel 业务错误码。

适用场景

  • 让 AI 助手直接查询 ThingsPanel 中的设备状态和最近遥测数据。
  • 通过自然语言查询告警或设备分组。
  • 在经用户确认后向设备下发指令。
  • 在支持 MCP 的客户端中自动查询 ThingsVis 仪表盘信息。

标签

#mcp#iot#model-context-protocol#python#device-management#telemetry#ai-agent

常见问题

thingspanel-mcp 是什么？
让 Claude、GPT 等 AI 助手通过 MCP 协议查询和控制 ThingsPanel 物联网平台设备及 ThingsVis 仪表盘的服务端。 ThingsPanel MCP 是一个基于 Python 的服务端，把 ThingsPanel 与 ThingsVis 的 API 封装为 Model Context Protocol 工具，使兼容 MCP 的 AI 助手可以用自然语言处理物联网数据和设备。共提供 378 个工具：14 个面向设备、遥测、仪表盘和指令的常用工具，以及 364 个按接口逐一命名的工具，覆盖 312 个 ThingsPanel 接口和 52 个 ThingsVis 接口。
thingspanel-mcp 可以免费使用吗？用的什么许可证？
thingspanel-mcp 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。
thingspanel-mcp 还在维护吗？
活跃维护中。thingspanel-mcp 最近一次提交是在 2026年10月8日。
thingspanel-mcp 适合用来做什么？
让 AI 助手直接查询 ThingsPanel 中的设备状态和最近遥测数据。 通过自然语言查询告警或设备分组。 在经用户确认后向设备下发指令。 在支持 MCP 的客户端中自动查询 ThingsVis 仪表盘信息。
在哪里获取 thingspanel-mcp？
源代码和安装说明在 GitHub 上：https://github.com/ThingsPanel/thingspanel-mcp

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目