{"id":29966271,"url":"https://github.com/thingspanel/thingspanel-mcp","last_synced_at":"2025-08-04T02:32:39.537Z","repository":{"id":281991018,"uuid":"947070208","full_name":"ThingsPanel/thingspanel-mcp","owner":"ThingsPanel","description":"This MCP server integrates ThingsPanel IoT platform with AI models like Claude, GPT, and others that support the Model Context Protocol. ","archived":false,"fork":false,"pushed_at":"2025-06-08T03:29:25.000Z","size":185,"stargazers_count":33,"open_issues_count":2,"forks_count":9,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-07-26T22:27:13.956Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ThingsPanel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-03-12T05:25:58.000Z","updated_at":"2025-07-24T19:37:57.000Z","dependencies_parsed_at":"2025-04-24T10:32:33.053Z","dependency_job_id":"a698a34d-be99-437a-b1da-bf6e5c2021bf","html_url":"https://github.com/ThingsPanel/thingspanel-mcp","commit_stats":null,"previous_names":["thingspanel/thingspanel-mcp"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/ThingsPanel/thingspanel-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThingsPanel%2Fthingspanel-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThingsPanel%2Fthingspanel-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThingsPanel%2Fthingspanel-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThingsPanel%2Fthingspanel-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ThingsPanel","download_url":"https://codeload.github.com/ThingsPanel/thingspanel-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThingsPanel%2Fthingspanel-mcp/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268639931,"owners_count":24282678,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-04T02:00:09.867Z","response_time":79,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-08-04T02:31:51.733Z","updated_at":"2025-08-04T02:32:39.524Z","avatar_url":"https://github.com/ThingsPanel.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ThingsPanel MCP [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE) [![Python Version](https://img.shields.io/pypi/pyversions/thingspanel-mcp.svg)](https://pypi.org/project/thingspanel-mcp/) [![PyPI version](https://badge.fury.io/py/thingspanel-mcp.svg)](https://badge.fury.io/py/thingspanel-mcp)\n\u003ca href=\"https://glama.ai/mcp/servers/@ThingsPanel/thingspanel-mcp\"\u003e\n  \u003cimg width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/@ThingsPanel/thingspanel-mcp/badge\" /\u003e\n\u003c/a\u003e\n\n[ThingsPanel](http://thingspanel.io/) IoT Platform's MCP (Model Context Protocol) Server.\n\n[English](README.md) | [中文](README_CN.md)\n\n## 🚀 Project Overview\n\nThingsPanel MCP Server is an innovative intelligent interface that enables you to:\n\n- Interact with IoT devices using natural language\n- Easily retrieve device information\n- Monitor device performance and status in real-time\n- Simplify device control commands\n- Analyze platform-wide statistical data and trends\n\n## Target Audience\n\n### Intended Users\n\n- **IoT Solution Developers**: Engineers and developers building solutions on the ThingsPanel IoT platform and seeking AI integration capabilities\n- **AI Integration Experts**: Professionals looking to connect AI models with IoT systems\n- **System Administrators**: IT personnel managing IoT infrastructure and wanting to enable AI-driven analysis and control\n- **Product Teams**: Teams building products that combine IoT and AI functionality\n\n### Problems Addressed\n\n- **Integration Complexity**: Eliminates the need to create custom integrations between AI models and IoT platforms\n- **Standardized Access**: Provides a consistent interface for AI models to interact with IoT data and devices\n- **Security Control**: Manages authentication and authorization for AI access to IoT systems\n- **Lowered Technical Barriers**: Reduces technical obstacles to adding AI capabilities to existing IoT deployments\n\n### Ideal Application Scenarios\n\n- **Natural Language IoT Control**: Enable users to control devices through AI assistants using natural language\n- **Intelligent Data Analysis**: Allow AI models to access and analyze IoT sensor data for insights\n- **Anomaly Detection**: Connect AI models to device data streams for real-time anomaly detection\n- **Predictive Maintenance**: Enable AI-driven predictive maintenance by providing device history access\n- **Automated Reporting**: Create systems that can generate IoT data reports and visualizations on demand\n- **Operational Optimization**: Use AI to optimize device operations based on historical patterns\n\n## ✨ Core Features\n\n- 🗣️ Natural Language Querying\n- 📊 Comprehensive Device Insights\n- 🌡️ Real-time Telemetry Data\n- 🎮 Convenient Device Control\n- 📈 Platform-wide Analytics\n\n## 🛠️ Prerequisites\n\n- Python 3.8+\n- ThingsPanel Account\n- ThingsPanel API Key\n\n## 📦 Installation\n\n### Option 1: Pip Installation\n\n```bash\npip install thingspanel-mcp\n```\n\n### Option 2: Source Code Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/ThingsPanel/thingspanel-mcp.git\n\n# Navigate to project directory\ncd thingspanel-mcp\n\n# Install the project\npip install -e .\n```\n\n## 🔐 Configuration\n\n### Configuration Methods (Choose One)\n\n#### Method 1: Direct Command Line Configuration (Recommended)\n\n```bash\nthingspanel-mcp --api-key \"Your API Key\" --base-url \"Your ThingsPanel Base URL\"\n```\n\n#### Method 2: Environment Variable Configuration\n\nIf you want to avoid repeated input, set environment variables:\n\n```bash\n# Add to ~/.bashrc, ~/.zshrc, or corresponding shell config file\nexport THINGSPANEL_API_KEY=\"Your API Key\"\nexport THINGSPANEL_BASE_URL=\"Your ThingsPanel Base URL\"\n\n# Then run\nsource ~/.bashrc  # or source ~/.zshrc\n```\n\n💡 Tips:\n\n- API keys are typically obtained from the API KEY management in the ThingsPanel platform\n- Base URL refers to your ThingsPanel platform address, e.g., `http://demo.thingspanel.cn/`\n- Command-line configuration is recommended to protect sensitive information\n\n## 🖥️ Claude Desktop Integration\n\nAdd the following to your Claude desktop configuration file (`claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"thingspanel\": {\n      \"command\": \"thingspanel-mcp\",\n      \"args\": [\n        \"--api-key\", \"Your API Key\",\n        \"--base-url\", \"Your Base URL\"\n      ]\n    }\n  }\n}\n```\n\n## 🤔 Interaction Examples\n\nUsing the ThingsPanel MCP Server, you can now make natural language queries such as:\n\n- \"What is the current temperature of my sensor?\"\n- \"List all active devices\"\n- \"Turn on the automatic sprinkler system\"\n- \"Show device activity for the last 24 hours\"\n\n## 🛡️ Security\n\n- Secure credential management\n- Uses ThingsPanel official API\n- Supports token-based authentication\n\n## License\n\nApache License 2.0\n\n## 🌟 Support Us\n\nIf this project helps you, please give us a star on GitHub! ⭐\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthingspanel%2Fthingspanel-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthingspanel%2Fthingspanel-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthingspanel%2Fthingspanel-mcp/lists"}