-
securityF
license-
qualityA server enabling seamless interaction between AI models and WordPress sites with secure, standardized communication using the WordPress REST API for comprehensive site management.
Last updated -
237
79
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.
Allows configuration via .env files for storing ThingsPanel API URLs and keys, simplifying environment setup for the MCP server.
Supports devices using the MQTT protocol for IoT communication, allowing the MCP server to interact with MQTT-enabled devices managed by ThingsPanel.
Available as a package on PyPI (Python Package Index), allowing simple installation via pip from the official Python package repository.
Integrates with pytest for testing, making it easier to verify the MCP server functionality during development.
Built on Python, enabling easy installation via pip and custom integrations with the ThingsPanel IoT platform.
Utilizes Shields.io for displaying status badges in documentation, showing license, Python version, and PyPI version information.
ThingsPanel MCP 
ThingsPanel IoT Platform's MCP (Model Context Protocol) Server.
🚀 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)
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
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! ⭐
Related MCP Servers
- -securityFlicense-qualityA server that provides rich UI context and interaction capabilities to AI models, enabling deep understanding of user interfaces through visual analysis and precise interaction via Model Context Protocol.Last updated -64
- -securityFlicense-qualityAn integration that enables AI assistants to interact with network data through a standardized protocol, providing AI-ready tools and interfaces for network automation and management.Last updated -15
- -securityAlicense-qualityA Model Context Protocol server that allows AI assistants to invoke and interact with Integrator automation workflows through an API connection.Last updated -3MIT License