ThingsPanel MCP는 MCP 호환 보조를 ThingsPanel 및 ThingsVis API에 연결합니다. 그것은 모두 초점을 맞춘 IoT 도구와 개별적으로 고정 된 API 도구, 소스 승인 경로.

Korean | 한국어

그것은 무엇을 포함

• 378 MCP 도구 : 364 생성 된 API 도구 플러스 14 집중 장치, 원격 측정, 대쉬보드 및 제어 도구.
• 생성된 세트는 장치, 원격 측정, 경보, 그룹, 제품, 서비스 접근, 대쉬보드 및 업로드를 포함하여 312 ThingsPanel 및 52 ThingsVis API 가동을 포함합니다.
• 178 생성된 읽기 가동. 나머지 186 쓰기 또는 제어 작업은 도구 인수가 확인 = true가 필요합니다.
• Structured JSON 결과, 비즈니스 코드 오류 검출, 경로 인코딩, 파일 업로드 지원 및 바인딩 SSE/WebSocket 읽기.
• ThingsPanel 및 ThingsVis의 인증 프로파일. 권한은 항상 연결된 서비스에 의해 시행됩니다.

완전한 허용 목록 API 재고는 src/thingspanel mcp/api manifest.json에 있습니다. 도구 정의는 HTTP 방법 및 경로 수정; 호출자는 path params, 쿼리, 몸, 옵션 file path 값을 제공합니다.

ok, summary]], data], error, error] 필드를 입력한 14가지의 초점 도구 반환 타입 MCP structuredContent.

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.