ThingsPanel MCP は、MCP 互換のアシスタントを ThingPanel と thingVis API に接続します。 集中した IoT ツールと、API ツールを個別に名前付け、定番のソース・オーディオ・ルートで提供しています。

日本語 English

含まれているもの

• 378 MCP ツール: 364 生成された API ツールと 14 の集中デバイス、テレメトリー、ダッシュボード、および制御ツール。
• 生成されたセットは、デバイス、テレメトリー、アラーム、グループ、製品、サービスアクセス、ダッシュボード、およびアップロードを含む312 ThingsPanelおよび52 ThingsVis API操作をカバーします。
• 178 生成された読み込み操作。 残り 186 の書き込みまたは制御操作は、ツール引数 check=true が必要です。
• 構造化されたJSON結果、ビジネスコードのエラー検出、パスエンコーディング、ファイルアップロードサポート、およびバインドされたSSE / WebSocket読み取り。
• ThingsPanelとCommentVisの認証プロファイル。 正規化は、常に接続されたサービスによって強制されます。

完全な allow-listed API 在庫は src/thingspanel mcp/api manifest.json にあります。 ツール定義は HTTP メソッドとルートを固定します。呼び出し側は、path params、query、body、およびオプションの file path 値を提供します。

[[T1], summary], [data]], [error]のフィールドで、14の焦点を絞ったツールがMCP [[T0]をタイプしました.

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.