MCP 服务器

ThingsPanel MCP
官方

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

智能家居与物联网

操作系统自动化

访问服务器

README

ThingsPanel MCP

ThingsPanel IoT 平台的 MCP (模型上下文协议) 服务器。

English | 中文

🚀 项目概览

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

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

目标受众

目标用户

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

解决的问题

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

理想的应用场景

自然语言 IoT 控制：使用户能够通过 AI 助手使用自然语言控制设备
智能数据分析：允许 AI 模型访问和分析 IoT 传感器数据以获取见解
异常检测：将 AI 模型连接到设备数据流以进行实时异常检测
预测性维护：通过提供设备历史记录访问权限来启用 AI 驱动的预测性维护
自动报告：创建可以按需生成 IoT 数据报告和可视化的系统
运营优化：使用 AI 根据历史模式优化设备运营

✨ 核心功能

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

🛠️ 前提条件

Python 3.8+
ThingsPanel 帐户
ThingsPanel API 密钥

📦 安装

选项 1：Pip 安装

pip install thingspanel-mcp

选项 2：源代码安装

# 克隆存储库
git clone https://github.com/ThingsPanel/thingspanel-mcp.git

# 导航到项目目录
cd thingspanel-mcp

# 安装项目
pip install -e .

🔐 配置

配置方法（选择一种）

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

thingspanel-mcp --api-key "您的 API 密钥" --base-url "您的 ThingsPanel 基础 URL"

方法 2：环境变量配置

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

# 添加到 ~/.bashrc、~/.zshrc 或相应的 shell 配置文件
export THINGSPANEL_API_KEY="您的 API 密钥"
export THINGSPANEL_BASE_URL="您的 ThingsPanel 基础 URL"

# 然后运行
source ~/.bashrc  # 或 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", "您的 API 密钥",
        "--base-url", "您的基础 URL"
      ]
    }
  }
}