Glama
Sign In

ThingsPanel MCP

Official
by ThingsPanel
GitHub
Python
Apache 2.0
9
  • Linux
  • Apple
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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.

ThingsPanel MCP

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

This server cannot be installed

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

An integration server that connects AI models with ThingsPanel IoT platform, allowing AI assistants to interact with IoT devices through natural language for device control, data retrieval, and management operations.

  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

                  Related Resources