Xiaodu 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：场景是否启用