📌Overview

Purpose: To provide an intelligent interface for seamless interaction between AI models and IoT devices on the ThingsPanel platform.

Overview: ThingsPanel MCP Server enables natural language communication with IoT devices, facilitating real-time performance monitoring, device control, and data analysis. It simplifies the integration of AI by offering standardized access to IoT data and services.

Key Features:

Natural Language Querying: Allows users to interact with IoT devices using conversational language for enhanced usability.
Comprehensive Device Insights: Provides detailed information about device statuses and functionalities, aiding in efficient management and monitoring.
Real-time Telemetry Data: Continuously tracks device performance, ensuring that users receive up-to-date information on operations.
Convenient Device Control: Simplifies the execution of device commands, offering users straightforward control mechanisms.
Platform-wide Analytics: Analyzes data trends across the platform, enabling better decision-making and operational insights.

ThingsPanel MCP

ThingsPanel IoT Platform's MCP (Model Context Protocol) Server.

English | 中文

🚀 Project Overview

ThingsPanel MCP Server is an intelligent interface that enables you to:

Interact with IoT devices using natural language
Retrieve device information easily
Monitor device performance and status in real-time
Simplify device control commands
Analyze platform-wide statistical data and trends

Target Audience

Intended Users

IoT Solution Developers building solutions on the ThingsPanel platform seeking AI integration
AI Integration Experts connecting AI models with IoT systems
System Administrators managing IoT infrastructure for AI-driven analysis and control
Product Teams combining IoT and AI functionality

Problems Addressed

Eliminates the need for custom integrations between AI models and IoT platforms
Provides a consistent interface for AI models to access IoT data and devices
Manages authentication and authorization for AI access
Reduces technical obstacles to adding AI to existing IoT deployments

Ideal Application Scenarios

Natural language IoT control through AI assistants
AI-based analysis of IoT sensor data
Real-time anomaly detection using AI on device data streams
AI-driven predictive maintenance with device history access
Automated reporting and visualization of IoT data
AI optimization of device operations based on historical data

✨ Core Features

Natural Language Querying
Comprehensive Device Insights
Real-time Telemetry Data
Convenient Device Control
Platform-wide Analytics

🛠️ Prerequisites

Python 3.8+
ThingsPanel Account
ThingsPanel API Key

📦 Installation

Option 1: Pip Installation

pip install thingspanel-mcp

Option 2: Source Code Installation

git clone https://github.com/ThingsPanel/thingspanel-mcp.git
cd thingspanel-mcp
pip install -e .

🔐 Configuration

Configuration Methods (Choose One)

Method 1: Direct Command Line Configuration (Recommended)

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

Method 2: Environment Variable Configuration

Set environment variables to avoid repeated input:

export THINGSPANEL_API_KEY="Your API Key"
export THINGSPANEL_BASE_URL="Your ThingsPanel Base URL"

source ~/.bashrc  # or source ~/.zshrc

Tips:

Obtain API keys from ThingsPanel API KEY management
Base URL example: http://demo.thingspanel.cn/
Command-line configuration is recommended to protect sensitive information

🖥️ Claude Desktop Integration

Add to your Claude desktop configuration file (claude_desktop_config.json):

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

🤔 Interaction Examples

Example natural language queries:

What is the current temperature of my sensor?
List all active devices
Turn on the automatic sprinkler system
Show device activity for the last 24 hours

🛡️ Security

Secure credential management
Uses ThingsPanel official API
Supports token-based authentication

License

Apache License 2.0

🌟 Support Us

If this project helps you, please give us a star on GitHub! ⭐