ThingsPanel MCP

ThingsPanel MCP

By ThingsPanel GitHub

This MCP server integrates ThingsPanel IoT platform with AI models like Claude, GPT, and others that support the Model Context Protocol.

Overview

What is ThingsPanel MCP?

ThingsPanel MCP is a Model Context Protocol server that integrates the ThingsPanel IoT platform with AI models like Claude and GPT, enabling seamless interaction between AI and IoT devices.

How to use ThingsPanel MCP?

To use ThingsPanel MCP, install it via pip, configure your ThingsPanel API key, and start the server. You can then send commands to IoT devices and retrieve data using the provided API endpoints.

Key features of ThingsPanel MCP?

  • Device management (create, update, delete devices)
  • Historical data retrieval and analysis
  • Alarm and notification management
  • Command and control for IoT devices
  • Integration with various AI models through the Model Context Protocol

Use cases of ThingsPanel MCP?

  1. Natural language control of IoT devices through AI assistants.
  2. Intelligent data analysis for insights from IoT sensor data.
  3. Anomaly detection in real-time device data streams.
  4. Predictive maintenance based on historical device data.
  5. Automated reporting and visualization of IoT data.

FAQ from ThingsPanel MCP?

  • Who is this for?

IoT solution developers, AI integration specialists, system administrators, and product teams looking to combine IoT and AI functionalities.

  • What problems does it solve?

It simplifies integration between AI models and IoT platforms, provides standardized access to IoT data, and enhances security control for AI access.

  • Is it easy to set up?

Yes! Installation is straightforward via pip, and configuration is done through environment variables.

Content

ThingsPanel MCP License Python Version PyPI version

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

English | 中文

🚀 Project Overview

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

  • Interact with IoT devices using natural language
  • Easily retrieve device information
  • 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: Engineers and developers building solutions on the ThingsPanel IoT platform and seeking AI integration capabilities
  • AI Integration Experts: Professionals looking to connect AI models with IoT systems
  • System Administrators: IT personnel managing IoT infrastructure and wanting to enable AI-driven analysis and control
  • Product Teams: Teams building products that combine IoT and AI functionality

Problems Addressed

  • Integration Complexity: Eliminates the need to create custom integrations between AI models and IoT platforms
  • Standardized Access: Provides a consistent interface for AI models to interact with IoT data and devices
  • Security Control: Manages authentication and authorization for AI access to IoT systems
  • Lowered Technical Barriers: Reduces technical obstacles to adding AI capabilities to existing IoT deployments

Ideal Application Scenarios

  • Natural Language IoT Control: Enable users to control devices through AI assistants using natural language
  • Intelligent Data Analysis: Allow AI models to access and analyze IoT sensor data for insights
  • Anomaly Detection: Connect AI models to device data streams for real-time anomaly detection
  • Predictive Maintenance: Enable AI-driven predictive maintenance by providing device history access
  • Automated Reporting: Create systems that can generate IoT data reports and visualizations on demand
  • Operational Optimization: Use AI to optimize device operations based on historical patterns

✨ 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

# 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 .

🔐 Configuration

Configuration Methods (Choose One)

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

Method 2: Environment Variable Configuration

If you want to avoid repeated input, set environment variables:

# 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

💡 Tips:

  • API keys are typically obtained from the API KEY management in the ThingsPanel platform
  • Base URL refers to your ThingsPanel platform address, e.g., http://demo.thingspanel.cn/
  • Command-line configuration is recommended to protect sensitive information

🖥️ Claude Desktop Integration

Add the following 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

Using the ThingsPanel MCP Server, you can now make natural language queries such as:

  • "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! ⭐

No tools information available.
No content found.