事物面板-mcp

Name: 事物面板-mcp
Author: ThingsPanel

作者：ThingsPanel41 星标更新：2025-06-08

安装使用来源：spider==github.com

项目介绍

ThingsPanel MCP

ThingsPanel 物联网平台的 MCP（模型上下文协议）服务器。

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：源代码安装

# 克隆仓库
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"
      ]
    }
  }
}

🤔 交互示例

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

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

🛡️ 安全

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

许可证

Apache 许可证 2.0

🌟 支持我们

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