把“查设备、看数据”交给 AI 助手：ThingsPanel MCP 0.1.10 已发布 - 技术博客

ThingsPanel MCP 工作流程信息图

工程师想查一台设备最近的遥测、告警或连接状态，往往要先找到对应页面，再切换筛选条件，或者翻 API 文档确认接口。ThingsPanel MCP 0.1.10 让兼容 MCP 的 AI 助手可以按授权身份调用 ThingsPanel 和 ThingsVis 能力：先用对话读取信息，需要写入或控制时，再明确确认具体动作。

这次发布的重点不是“让 AI 自动替你操作一切”，而是给 AI 助手一条可配置、可核对、受服务端权限约束的平台调用路径。你可以从只读查询开始，再按团队流程逐步启用需要确认的操作。

一句话看懂 ThingsPanel MCP

MCP 是 AI 助手连接外部工具的一种开放协议。ThingsPanel MCP 把 ThingsPanel 与 ThingsVis 的 API 能力封装成 MCP 工具，让兼容的 AI 助手能够发现并调用它们。

0.1.10 运行时共注册 376 个工具：363 个由 API 清单生成，另有 13 个面向设备、遥测、看板和控制场景的快捷工具。生成工具覆盖设备、遥测、告警、分组、产品、服务接入、看板和文件上传等操作。

从一句提问，到一条可控的调用流程

一次调用大致经过四步：

选择身份：通过 profile 配置 ThingsPanel 或 ThingsVis 凭证。
连接助手：在兼容 MCP 的客户端中配置本机 stdio 服务。
读取信息：让助手调用设备、遥测、告警、分组或看板相关工具。
确认操作：写入或控制工具需要 confirmed=true；只有在用户确认具体动作后才传入该参数。

工具绑定仓库中的固定 HTTP 方法和 API 路由，调用方不能临时指定任意 URL 或方法。实际权限仍由连接的服务端校验，MCP 参数不能用来伪造更高角色。这样，AI 助手能帮用户更快找到平台信息，同时保留现有账号和后端授权边界。

写操作的确认门槛怎么工作

363 个生成 API 工具中，177 个是读取操作；其余 186 个写入或控制操作要求传入 confirmed=true。

如果没有确认，工具会返回 confirmation_required 和请求预览，不会发送写请求。用户确认具体动作后，客户端才能把 confirmed 设为 true。这是一层额外保护，不能代替用户判断，也不能绕过服务端权限校验。

几分钟完成本机接入

ThingsPanel MCP 支持 Python 3.8 及以上版本。想先试运行，可以用 uvx，无需全局安装：

uvx --from thingspanel-mcp==0.1.10 thingspanel-mcp --help

在客户端配置 MCP 服务时，常用方式同样是由 uvx 启动固定版本：

[mcp_servers.thingspanel]
command = "uvx"
args = ["--from", "thingspanel-mcp==0.1.10", "thingspanel-mcp"]

[mcp_servers.thingspanel.env]
THINGSPANEL_CONFIG_PATH = "/绝对路径/.thingspanel/config.json"

凭证放在本机受保护的 ~/.thingspanel/config.json 中，再通过 THINGSPANEL_CONFIG_PATH 指向该文件。可以为不同角色配置 profile；未显式指定时使用 default。不要把真实 token 写进共享仓库或提交到客户端配置文件。

Codex 和 Claude Desktop 都可以通过本机 stdio 配置接入。WorkBuddy 也可按其本机 MCP 配置方式连接；WorkBuddy 连接器市场版本还需单独准备连接器清单、凭证表单并提交审核，目前尚未上架。

哪些团队适合先试

平台开发与运维人员：用自然语言查询设备、遥测或告警信息，减少在页面与接口文档间来回切换。
项目集成人员：在服务端权限允许的范围内，按需调用平台 API，辅助核对设备和看板配置。
正在构建 AI 工作流的团队：先启用读取工具验证适配，再为确有需要的写操作保留逐次确认。

从只读工具起步，确认 profile、服务地址和返回结果都符合预期，再评估是否需要写入或控制权限，是更容易落地的接入顺序。

开始使用

ThingsPanel MCP 0.1.10 已发布到 PyPI。你可以先查看完整的中文配置说明、客户端示例和工具调用约定，再选择本机试运行或源码安装：