ThingsPanel MCP соединяет MCP-совместимых помощников с API ThingsPanel и ThingsVis. Он предлагает как специализированные инструменты IoT, так и индивидуально названные инструменты API с фиксированными, проверенными источниками маршрутами.

Английский | 中

Что включает в себя

378 инструментов MCP: 364 созданных инструмента API плюс 14 сфокусированных устройств, телеметрия, приборная панель и инструменты управления. Созданный набор охватывает 312 операций ThingsPanel и 52 операции API ThingsVis, включая устройства, телеметрию, сигнализацию, группы, продукты, доступ к услугам, панели инструментов и загрузки.

• 178 сгенерированных операций чтения. Остальные 186 операций записи или управления требуют подтверждения аргумента инструмента. Структурированные результаты JSON, обнаружение ошибок бизнес-кода, кодирование пути, поддержка загрузки файлов и ограниченные чтения SSE / WebSocket. Профили аутентификации для ThingsPanel и ThingsVis. Авторизация всегда обеспечивается подключенным сервисом.

Полный список API-интерфейсов находится в src/thingspanel mcp/api manifest.json. Определения инструмента фиксируют метод и маршрут HTTP; абоненты предоставляют значения Path params, запроса, тела и дополнительных значений File path.

14 инструментов возвращают тип MCP structuredContent с ok, summary, data и error полями.

ThingsPanel MCP

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/thingspanel_mcp/api_manifest.json. The tool definitions fix the HTTP method and route; callers provide path_params, query, body, and optional file_path 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. send_device_command returns a message_id when available; pass it to get_device_command_status 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 SYS_ADMIN and TENANT_ADMIN. 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.