使用说明
小度IoT MCP Server
一个基于 Model Context Protocol (MCP) 的小度IoT服务,让AI应用能够无缝控制小度IoT智能设备。支持Claude、Cursor、Cline等所有兼容MCP协议的平台。
✨ 特性
- 🎯 外设控制 - 通过自然语言指令控制小度IoT各类智能设备
- 🎯 外设查询 - 查询小度IoT智能设备列表和状态详情
- 🎯 场景渲染 - 控制已有场景或者让模型自己渲染场景
- 🎯 场景查询 - 查询小度IoT场景列表
📋 目录
🚀 快速开始
前提条件
- 百度开发者账号
- 小度智能设备
- 支持MCP的AI工具(Claude、Cursor、Cline等)
获取访问令牌
🔌 接入方式
Stdio 接入
支持的工具
- Cursor ✅
- Claude Desktop ✅
- Cline ✅
- 其他支持MCP的工具 ✅
配置
以 Cursor 为例:
- 打开 Cursor → 设置 → MCP
- 编辑
mcp.json配置文件:
{
"mcpServers": {
"dueros-iot-mcp": {
"command": "npx",
"args": [
"-y",
"dueros-iot-mcp"
],
"env": {
"ACCESS_TOKEN": "你的ACEESS_TOKEN"
}
}
}
}
- 保存配置,重启Cursor
- 在会话中选择 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:场景是否启用