简介

一个将AI模型与ThingsPanel物联网平台连接起来的集成服务器，允许AI助手通过自然语言与物联网设备进行交互，以实现设备控制、数据检索和管理操作。

简介

一个将AI模型与ThingsPanel物联网平台连接起来的集成服务器，允许AI助手通过自然语言与物联网设备进行交互，以实现设备控制、数据检索和管理操作。

ThingsPanel MCP

ThingsPanel 物联网平台的MCP（Model Context Protocol）服务器。

English | 中文

🚀 项目概述

ThingsPanel MCP 服务器是一个创新的智能接口，它使您能够：

• 使用自然语言与物联网设备交互
• 轻松检索设备信息
• 实时监控设备性能和状态
• 简化设备控制命令
• 分析平台级统计数据和趋势

目标受众

预期用户

• 物联网解决方案开发者：在ThingsPanel物联网平台上构建解决方案并寻求AI集成能力的工程师和开发人员
• AI集成专家：希望将AI模型与物联网系统连接的专业人士
• 系统管理员：管理物联网基础设施并希望启用AI驱动分析和控制的IT人员
• 产品团队：构建结合了物联网和AI功能的产品的团队

解决的问题

• 集成复杂性：消除了在AI模型和物联网平台之间创建自定义集成的需求
• 标准化访问：为AI模型提供一致的接口以与物联网数据和设备交互
• 安全控制：管理AI访问物联网系统的身份验证和授权
• 降低技术门槛：减少向现有物联网部署添加AI功能的技术障碍

理想应用场景

• 自然语言物联网控制：通过AI助手使用自然语言控制设备
• 智能数据分析：允许AI模型访问并分析物联网传感器数据以获取洞察
• 异常检测：将AI模型连接到设备数据流以实现实时异常检测
• 预测性维护：通过提供设备历史记录访问来启用AI驱动的预测性维护
• 自动化报告：创建可以根据需要生成物联网数据报告和可视化的系统
• 运营优化：基于历史模式使用AI优化设备操作

✨ 核心功能

• 🗣️ 自然语言查询
• 📊 全面的设备洞察
• 🌡️ 实时遥测数据
• 🎮 方便的设备控制
• 📈 平台级分析

🛠️ 前提条件

• Python 3.8+
• ThingsPanel账号
• ThingsPanel API密钥

📦 安装

选项1：Pip安装

pip install thingspanel-mcp

选项2：源代码安装

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

🔐 配置

配置方法（选择一种）

方法1：直接命令行配置（推荐）

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

方法2：环境变量配置

如果您想避免重复输入，请设置环境变量：

# 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

💡 小贴士：

• API 密钥通常从 ThingsPanel 平台的 API 密钥管理中获取
• 基础 URL 指的是您的 ThingsPanel 平台地址，例如 http://demo.thingspanel.cn/
• 建议通过命令行配置来保护敏感信息

🖥️ Claude 桌面集成

将以下内容添加到您的 Claude 桌面配置文件 (claude_desktop_config.json) 中：

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

🤔 交互示例

使用 ThingsPanel MCP 服务器，您现在可以进行自然语言查询，如：

• "我的传感器当前温度是多少？"
• "列出所有活动设备"
• "打开自动喷水系统"
• "显示过去 24 小时内的设备活动"

🛡️ 安全性

• 安全凭证管理
• 使用 ThingsPanel 官方 API
• 支持基于令牌的身份验证

许可证

Apache License 2.0

🌟 支持我们

如果这个项目对您有帮助，请在 GitHub 上给我们一个星标！⭐

服务配置

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

来源

• 来源：github
• 链接：https://github.com/ThingsPanel/thingspanel-mcp