ThingsPanel MCP

Official

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Allows configuration via .env files for storing ThingsPanel API URLs and keys, simplifying environment setup for the MCP server.

  • Provides containerized deployment of the MCP server through Docker, with support for Docker Compose to easily run both the ThingsPanel MCP server and MCP Inspector for debugging.

  • Supports devices using the MQTT protocol for IoT communication, allowing the MCP server to interact with MQTT-enabled devices managed by ThingsPanel.

シングスパネルMCP

ThingsPanel IoT プラットフォームの MCP (モデル コンテキスト プロトコル) サーバー。

英語|中国語

🚀 プロジェクト概要

ThingsPanel MCP Server は、次のことを可能にする革新的なインテリジェント インターフェースです。

  • 自然言語を使用して IoT デバイスと対話する
  • デバイス情報を簡単に取得
  • デバイスのパフォーマンスとステータスをリアルタイムで監視
  • デバイス制御コマンドを簡素化
  • プラットフォーム全体の統計データと傾向を分析する

ターゲットオーディエンス

対象ユーザー

  • IoTソリューション開発者: ThingsPanel IoTプラットフォーム上でソリューションを構築し、AI統合機能を求めているエンジニアと開発者
  • AI統合エキスパート:AIモデルとIoTシステムの接続を目指す専門家
  • システム管理者: IoTインフラストラクチャを管理し、AI主導の分析と制御を可能にしたいIT担当者
  • 製品チーム: IoTとAI機能を組み合わせた製品を構築するチーム

対処された問題

  • 統合の複雑さ: AIモデルとIoTプラットフォーム間のカスタム統合を作成する必要性を排除します
  • 標準化されたアクセス: AIモデルがIoTデータやデバイスと対話するための一貫したインターフェースを提供します。
  • セキュリティ制御: IoTシステムへのAIアクセスの認証と承認を管理します
  • 技術的障壁の低減: 既存の IoT 展開に AI 機能を追加する際の技術的障壁を低減します。

理想的なアプリケーションシナリオ

  • 自然言語によるIoT制御:ユーザーが自然言語を使用してAIアシスタントを通じてデバイスを制御できるようにする
  • インテリジェントデータ分析: AIモデルがIoTセンサーデータにアクセスして分析し、洞察を得られるようにします。
  • 異常検出: AI モデルをデバイスのデータ ストリームに接続して、リアルタイムの異常検出を実現します。
  • 予知保全:デバイス履歴へのアクセスを提供することで、AIによる予知保全を可能にします。
  • 自動レポート作成: オンデマンドで IoT データレポートと視覚化を生成できるシステムを作成します。
  • 運用の最適化: AIを使用して、履歴パターンに基づいてデバイスの操作を最適化します。

✨ コア機能

  • 🗣️ 自然言語クエリ
  • 📊 包括的なデバイスインサイト
  • 🌡️ リアルタイムテレメトリデータ
  • 🎮 便利なデバイスコントロール
  • 📈 プラットフォーム全体の分析

🛠️ 前提条件

  • Python 3.8以上
  • ThingsPanelアカウント
  • ThingsPanel APIキー

📦 インストール

オプション1: Pipインストール

pip install thingspanel-mcp

オプション2: ソースコードのインストール

# Clone the repository git clone https://github.com/ThingsPanel/thingspanel-mcp.git # Navigate to project directory cd thingspanel-mcp # Install the project pip install -e .

🔐 構成

設定方法(いずれかを選択)

方法 1: 直接コマンドライン構成 (推奨)

thingspanel-mcp --api-key "Your API Key" --base-url "Your ThingsPanel Base URL"

方法2: 環境変数の設定

繰り返し入力を避けたい場合は、環境変数を設定します。

# Add to ~/.bashrc, ~/.zshrc, or corresponding shell config file export THINGSPANEL_API_KEY="Your API Key" export THINGSPANEL_BASE_URL="Your ThingsPanel Base URL" # Then run source ~/.bashrc # or source ~/.zshrc

💡ヒント:

  • APIキーは通常、ThingsPanelプラットフォームのAPIキー管理から取得されます。
  • ベース URL は、ThingsPanel プラットフォームのアドレスを参照します (例: http://demo.thingspanel.cn/
  • 機密情報を保護するにはコマンドライン設定が推奨されます

🖥️ クロード デスクトップ統合

Claude デスクトップ構成ファイル ( claude_desktop_config.json ) に次のコードを追加します。

{ "mcpServers": { "thingspanel": { "command": "thingspanel-mcp", "args": [ "--api-key", "Your API Key", "--base-url", "Your Base URL" ] } } }

🤔 インタラクションの例

ThingsPanel MCP サーバーを使用すると、次のような自然言語クエリを実行できるようになりました。

  • 「センサーの現在の温度はどれくらいですか?」
  • 「すべてのアクティブなデバイスを一覧表示する」
  • 「自動スプリンクラーシステムをオンにしてください」
  • 「過去24時間のデバイスアクティビティを表示」

🛡️ セキュリティ

  • 安全な資格情報管理
  • ThingsPanel公式APIを使用
  • トークンベースの認証をサポート

ライセンス

Apacheライセンス2.0

🌟 私たちをサポートしてください

このプロジェクトが役に立った場合は、GitHub でスターを付けてください。⭐

-
security - not tested
A
license - permissive license
-
quality - not tested

AI モデルを ThingsPanel IoT プラットフォームに接続する統合サーバー。AI アシスタントが自然言語を介して IoT デバイスと対話し、デバイスの制御、データの取得、管理操作を行うことができます。

  1. 🚀 Project Overview
    1. Target Audience
      1. Intended Users
      2. Problems Addressed
      3. Ideal Application Scenarios
    2. ✨ Core Features
      1. 🛠️ Prerequisites
        1. 📦 Installation
          1. Option 1: Pip Installation
          2. Option 2: Source Code Installation
        2. 🔐 Configuration
          1. Configuration Methods (Choose One)
        3. 🖥️ Claude Desktop Integration
          1. 🤔 Interaction Examples
            1. 🛡️ Security
              1. License
                1. 🌟 Support Us
                  ID: rmf6vsucns