小度IoT

小度 IoT 现已全面兼容 MCP 协议,涵盖设备控制、状态查询、场景获取与触发等功能。小度IoT全屋方向拥有完善的一方产品矩阵,同时还支持1800+智能家居厂商设备控制,借助小度MCP Server,开发者仅需简单配置,便可快速打通小度IoT生态资源,实现应用业务赋能。

  • 本地部署
  • 更新于

使用说明

小度IoT MCP Server

一个基于 Model Context Protocol (MCP) 的小度IoT服务,让AI应用能够无缝控制小度IoT智能设备。支持Claude、Cursor、Cline等所有兼容MCP协议的平台。

✨ 特性

  • 🎯 外设控制 - 通过自然语言指令控制小度IoT各类智能设备
  • 🎯 外设查询 - 查询小度IoT智能设备列表和状态详情
  • 🎯 场景渲染 - 控制已有场景或者让模型自己渲染场景
  • 🎯 场景查询 - 查询小度IoT场景列表

📋 目录

🚀 快速开始

前提条件

  • 百度开发者账号
  • 小度智能设备
  • 支持MCP的AI工具(Claude、Cursor、Cline等)

获取访问令牌

  1. 访问百度开发者平台
  2. 按照接入授权文档获取access_token
  3. 保存好您的access_token,后续配置时需要使用

🔌 接入方式

Stdio 接入

支持的工具

  • Cursor ✅
  • Claude Desktop ✅
  • Cline ✅
  • 其他支持MCP的工具 ✅

配置

以 Cursor 为例:

  1. 打开 Cursor → 设置 → MCP
  2. 编辑 mcp.json 配置文件:
   {
     "mcpServers": {
       "dueros-iot-mcp": {
         "command": "npx",
         "args": [
           "-y",
           "dueros-iot-mcp"
         ],
         "env": {
           "ACCESS_TOKEN": "你的ACEESS_TOKEN" 
         }
       }
     }
   }
  1. 保存配置,重启Cursor
  2. 在会话中选择 Agent 模式开始使用

Claude Desktop 配置示例:

编辑 claude_desktop_config.json:

{
  "mcpServers": {
    "dueros-iot-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "dueros-iot-mcp"
      ],
      "env": {
        "ACCESS_TOKEN": "你的ACEESS_TOKEN" 
      }
    }
  }
}

🛠️ 工具说明

本MCP服务器提供以下4个工具,让您能够完全控制小度IoT智能设备:

设备控制 IOT_CONTROL_DEVICES

  • 说明:控制智能家居设备工具
  • 输入:
    • action:操作类型
    • applianceName:设备名称
    • roomName:房间名称
    • attribute:设备属性
    • value:设备属性值
  • 输出:
    • status:状态
    • msg:消息
    • data:数据
    • logId:日志ID

查询设备列表和状态 GET_ALL_DEVICES_WITH_STATUS

  • 说明:查询所有智能家居设备列表和状态工具
  • 输入:
    • applianceName:设备名称
    • roomName:房间名称
  • 输出:
    • list:设备列表
      • applianceName:设备名称
      • roomName:房间名称
      • applianceTypes:设备类型

场景触发 TRIGGER_SCENES

  • 说明:触发场景工具
  • 输入:
    • sceneName:场景名称
  • 输出:
    • status:状态
    • msg:消息
    • data:数据
    • logId:日志ID

场景查询 GET_ALL_SCENES

  • 说明:查询场景列表工具
  • 输入:
    • sceneName:场景名称
  • 输出:
    • list:场景列表
      • sceneName:场景名称
      • roomName:房间名称
      • sceneEnable:场景是否启用