T
ThingsPanel/thingspanel-mcp
Devices and data on the ThingsPanel IoT platform
在 GitHub 查看 ↗链接已于 2026-11-12 核查 · HTTP 200 · 打开的是厂商自己的官网
安装与配置
- 复制上面的命令
- 粘成
claude_desktop_config.json里mcpServers的一项（本地服务器用 command + args，示例见 客户端接法） - 重启客户端
客户端配置（取自该仓库的安装命令）
{
"mcpServers": {
"thingspanel-thingspanel-mcp": {
"command": "uvx",
"args": ["--from", "thingspanel-mcp==0.1.11", "thingspanel-mcp"]
}
}
}解析自我们于 2026-11-05 抓取的该仓库 README；我们未执行过。
command/args 来自仓库写明的安装命令；不确定时请以该项目 README 为准。
VS Code（.vscode/mcp.json —— 键名是 servers）
{
"servers": {
"thingspanel-thingspanel-mcp": {
"command": "uvx",
"args": ["--from", "thingspanel-mcp==0.1.11", "thingspanel-mcp"]
}
}
}VS Code 顶层键是 <code>servers</code>，其余与上面那份相同。
Claude Code（命令行）
claude mcp add --transport stdio thingspanel-thingspanel-mcp -- uvx --from thingspanel-mcp==0.1.11 thingspanel-mcp
Claude Code 不收 JSON 文件，用这条命令直接加。
配置项的键名以你的客户端为准：客户端与 CLI
- 来源明细
- 收录自 abordage/awesome-mcp 榜单（我们从中收集的条目之一） · 条目类型：MCP 服务
- 收录与活跃
- 收录于 2026-11-05 · 最近见到 2026-11-14 · 共见到 10 次 · 被 10 个来源列出
- 评分构成
- 综合分 1,003 · 10 个来源 · mcp
- 安装
uvx --from thingspanel-mcp==0.1.11 thingspanel-mcp
常见问题（答案都来自我们的记录）
怎么安装？
该仓库给出的安装命令是
uvx --from thingspanel-mcp==0.1.11 thingspanel-mcp。我们的记录里它是仓库自己提供的；不保证在你的客户端上直接可用。它适合谁 / 用来做什么？
我们把它归在这些标签下: MCP 服务。标签来自条目自身，不是我们强加的分类。
谁维护它、还在更新吗？
我们收录于 2026-11-05；最近见到 2026-11-14。这里没有"官方认证"或"质量评级"——我们只记录来源与时间。
# ThingsPanel MCP
以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →
ThingsPanel MCP connects MCP-compatible assistants to ThingsPanel and ThingsVis APIs. It offers both focused IoT tools and individually named API tools with fixed, source-audited routes.
English | 中文
## What it includes
378 MCP tools: 364 generated API tools plus 14 focused device, telemetry, dashboard, and control tools.
The generated set covers 312 ThingsPanel and 52 ThingsVis API operations, including device, telemetry, alarms, groups, products, service access, dashboards, and uploads.
178 generated read operations. The remaining 186 write or control operations require the tool argument confirmed=true.
Structured JSON results, business-code error detection, path encoding, file upload support, and bounded SSE/WebSocket reads.
Authentication profiles for ThingsPanel and ThingsVis. Authorization is always enforced by the connected service.
The complete allow-listed API inventory is in src/thingspanelmcp/apimanifest.json. The tool definitions fix the HTTP method and route; callers provide pathparams, query, body, and optional filepath values.
The 14 focused tools return typed MCP structuredContent with ok, summary, data, and error fields. Use the data fields for programmatic decisions; summary is for people. senddevicecommand returns a messageid when available; pass it to getdevicecommandstatus to query the command receipt. An accepted command is not proof that the device executed it.
## Requirements and installation
Python 3.8 or later.
A ThingsPanel account and a credential accepted by the target API. ThingsVis operations may require ThingsVis credentials as well.
Install from PyPI:
python -m pip install --upgrade thingspanel-mcp
Run without a persistent installation using uv:
uvx --from thingspanel-mcp thingspanel-mcp --help
Install from source:
git clone https://github.com/ThingsPanel/thingspanel-mcp.git
cd thingspanel-mcp
python -m pip install .
## Authentication and permissions
ThingsPanel Community supports SYSADMIN and TENANTADMIN. It does not have tenant subusers; tenant-user accounts are an Enterprise edition capability. ThingsPanel API keys map to tenant-administrator permissions. A system administrator must use a ThingsPanel login JWT.
ThingsVis credentials are separate from ThingsPanel credentials. The ThingsVis SSO exchange uses the ThingsPanel JWT from the selected profile; ThingsVis validates that token server-to-server and derives the role from the verified identity. The MCP caller cannot submit a role or user identity to elevate access.
Use a profile for each identity. The default profile is used when a tool does not specify profile. The 14 focused convenience tools use the default profile; the generated API tools accept an explicit profile argument.
Create ~/.thingspanel/config.json:
"baseurl": "https://thingspanel.example.com",
"apiprefix": "/api/v1",
"thingsvisbaseurl": "https://thingsvis.example.com",
"thingsvisapiprefix": "/api/v1",
"profiles": {
"default": {
"thingspaneltoken": " ",
"thingsvistoken": " ",
"thingsvisopenapikey": " "
},
"tenantadmin": {
"thingspaneltoken": " "
},
"superadmin": {
"thingspaneltoken": " "
Keep this file private; on macOS or Linux, restrict access with chmod 600 ~/.thingspanel/config.json. Never commit real credentials.
English | 中文
## What it includes
378 MCP tools: 364 generated API tools plus 14 focused device, telemetry, dashboard, and control tools.
The generated set covers 312 ThingsPanel and 52 ThingsVis API operations, including device, telemetry, alarms, groups, products, service access, dashboards, and uploads.
178 generated read operations. The remaining 186 write or control operations require the tool argument confirmed=true.
Structured JSON results, business-code error detection, path encoding, file upload support, and bounded SSE/WebSocket reads.
Authentication profiles for ThingsPanel and ThingsVis. Authorization is always enforced by the connected service.
The complete allow-listed API inventory is in src/thingspanelmcp/apimanifest.json. The tool definitions fix the HTTP method and route; callers provide pathparams, query, body, and optional filepath values.
The 14 focused tools return typed MCP structuredContent with ok, summary, data, and error fields. Use the data fields for programmatic decisions; summary is for people. senddevicecommand returns a messageid when available; pass it to getdevicecommandstatus to query the command receipt. An accepted command is not proof that the device executed it.
## Requirements and installation
Python 3.8 or later.
A ThingsPanel account and a credential accepted by the target API. ThingsVis operations may require ThingsVis credentials as well.
Install from PyPI:
python -m pip install --upgrade thingspanel-mcp
Run without a persistent installation using uv:
uvx --from thingspanel-mcp thingspanel-mcp --help
Install from source:
git clone https://github.com/ThingsPanel/thingspanel-mcp.git
cd thingspanel-mcp
python -m pip install .
## Authentication and permissions
ThingsPanel Community supports SYSADMIN and TENANTADMIN. It does not have tenant subusers; tenant-user accounts are an Enterprise edition capability. ThingsPanel API keys map to tenant-administrator permissions. A system administrator must use a ThingsPanel login JWT.
ThingsVis credentials are separate from ThingsPanel credentials. The ThingsVis SSO exchange uses the ThingsPanel JWT from the selected profile; ThingsVis validates that token server-to-server and derives the role from the verified identity. The MCP caller cannot submit a role or user identity to elevate access.
Use a profile for each identity. The default profile is used when a tool does not specify profile. The 14 focused convenience tools use the default profile; the generated API tools accept an explicit profile argument.
Create ~/.thingspanel/config.json:
"baseurl": "https://thingspanel.example.com",
"apiprefix": "/api/v1",
"thingsvisbaseurl": "https://thingsvis.example.com",
"thingsvisapiprefix": "/api/v1",
"profiles": {
"default": {
"thingspaneltoken": " ",
"thingsvistoken": " ",
"thingsvisopenapikey": " "
},
"tenantadmin": {
"thingspaneltoken": " "
},
"superadmin": {
"thingspaneltoken": " "
Keep this file private; on macOS or Linux, restrict access with chmod 600 ~/.thingspanel/config.json. Never commit real credentials.
收录徽章（可选）
想把收录标记放进 README 就复制这行，可选，不影响收录。
[](https://anclum.com/zh/s/thingspanel-thingspanel-mcp/)
- 来源
- awesome · https://github.com/ThingsPanel/thingspanel-mcp
- 按领域浏览
- MCP 服务
- 收录来源
- 10 个独立来源
- 收录于
- 今天
同类推荐
所属领域与标签
每个标签都能点进去看同类的全部条目。数字是当前库里的真实条数。