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 Desktop 集成

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

{
  "mcpServers": {
    "thingspanel": {
      "command": "thingspanel-mcp",
      "args": [
        "--api-key", "您的 API 密钥",
        "--base-url", "您的基础 URL"
      ]
    }
  }
}

🤔 交互示例

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

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

🛡️ 安全

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

许可证

Apache License 2.0

🌟 支持我们

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