Yeelight IoT MCP Server
Server Details
Yeelight device discovery, state, control, and scene execution.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- Yeelight/yeelight-iot-mcp
- GitHub Stars
- 10
- Server Listing
- Yeelight IoT MCP
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 8 tools
Each tool targets a distinct resource or action: control_node for node control, execute_scene for scenes, and get_* for listing specific entity types. No two tools overlap in purpose, though control_node is broad and depends on the get_* tools for IDs.
All tools use consistent snake_case verb_noun naming (get_*, control_node, execute_scene). The only flaw is a typo in get_currnet_house_info, which is a minor deviation from otherwise predictable naming.
8 tools is well-scoped for an IoT control server: one flexible control tool, one scene executor, and six specific getters. No tool feels redundant or missing for the core scope.
The surface covers entity discovery (house, areas, rooms, devices, groups, scenes) and control execution, but it lacks a dedicated tool to retrieve supported properties for a node, which control_node explicitly requires for safe operation. There is also no direct state-query tool, leaving a notable gap for an IoT control server.
Available Tools
8 toolscontrol_nodeAInspect
工具用途:节点控制
家庭、区域、房间、设备组、设备都被视为"节点",其类型通过 nodeType 区分。
节点控制请求中的 nodeId 是节点的唯一标识。用户通常提供的是节点名称,因此在调用控制接口前,必须先使用相应工具获取节点nodeId,nodeId可以是家庭ID,区域ID,房间ID,设备组ID,设备ID,确认后再执行控制操作。
节点控制指令通过 command 区分不同的操作。
控制指令中参数的 value 类型需与节点属性值的类型一致。
在调用此接口之前,请先确认节点支持的属性及其对应的可操作类型。如果目标节点不支持该属性,则无法进行控制。
控制指令中的propName(参数名称propName请勿传错)参数,必须填写节点属性列表中对应属性的 propId 字段值,如 p(开关)、c(颜色)、ct(色温)、l(亮度)、tp(窗帘开合度)等。应根据节点属性列表中支持的 propId 选择最合适的属性来进行控制操作。
控制节点说明
家庭、区域、房间、设备组、设备都被视为"节点",其类型通过 nodeType 区分。
例如:
"关闭所有灯"的请求,可视为关闭家庭下所有的灯,可以使用家庭节点类型来实现。
"打开客厅灯"的请求,可以使用房间节点类型来实现。
节点类型(nodeType)信息列表
节点类型(node) | 节点编码(nodeType) | 节点描述 | 说明 |
house | 5 | 家庭 | 例如:"关闭所有灯"的请求,可视为关闭家庭下所有的灯,可以使用家庭节点类型来实现。先通过获取家庭信息工具获取到家庭ID,再使用家庭ID控制家庭下的所有灯。 |
area | 3 | 区域 | 控制某个区域,可先通过获取区域的工具获取到区域ID,来控制区域。 |
room | 1 | 房间 | 控制某个房间,可先通过获取区域的工具获取到房间ID,来控制房间。 |
group | 4 | 设备组、灯组 | 控制某个设备组,可先通过获取区域的工具获取到设备组ID,来控制设备组。 |
device | 2 | 设备 | 控制某个设备,可先通过获取区域的工具获取到设备ID,来控制设备。 |
控制属性说明
可以通过其他工具获取到节点支持的属性定义列表,表示该节点所支持的属性。所控制节点的属性必须在该节点的属性定义列表中存在,否则会发生错误。
调用该工具控制节点属性时,传入的属性值需符合属性定义中的类型、取值范围、枚举值等的要求。
默认 dryRun=true,只返回执行计划,不调用真实控制接口。
如需真实执行,必须显式传 dryRun=false 且 confirmSideEffect=true。
相关属性信息列表
下面是一些属性的定义,可能会与其他工具中返回的属性定义冗余,供参考。
属性编码(propId/propName) | 属性描述(desc) | 属性格式(format) | 属性单位(unit) | 属性值范围(valueRange) | 属性值枚举(valueList) | 属性支持的操作(operators) | 属性说明 |
p | 开关属性(仅用于标识灯和开关类设备的开关状态) | boolean | - | - | true:开, false:关 | set | true:开, false:关 |
l | 亮度 | uint8 | % | min:1;max:100;step:1; | - | set | 例如:80表示亮度值为80% |
c | 颜色 | uint32 | RGB | min:0;max:16777215;step:1; | - | set | 十进制整形的RGB颜色表示。例如16711680表示红色(十六进制表示为#FF0000), 255表示蓝色(十六进制表示为#0000FF) |
ct | 色温 | uint8 | K | min:2700;max:6500;step:1; | - | set | 色温 |
tp | 窗帘目标开合度 | uint8 | % | min:0;max:100;step:1; | - | set | 窗帘目标开合度,用于控制窗帘开合度,0代表完全关闭,100代表完全打开。例如30表示窗帘开合度为30% |
Inputs: controlRequest (required). Returns: ok, code, plan, dryRun, +2 more
execute_sceneAInspect
工具用途:执行情景(场景、模式)。
在执行情景(场景、模式)前,必须确保已获取到对应的情景ID。由于用户通常提供的是情景名称,因此请务必先通过相应的工具获取情景ID,再使用该ID执行情景操作。
默认 dryRun=true,只返回执行计划,不调用真实执行接口。
如需真实执行,必须显式传 dryRun=false 且 confirmSideEffect=true。
Inputs: request (required). Returns: ok, code, plan, dryRun, +2 more
get_areasCInspect
获取当前用户家庭(项目)下所有的区域
Inputs: limit, cursor. Returns: rows, total, isError, pageNum, +3 more
get_currnet_house_infoBInspect
获取用户当前家庭(或项目)的信息
Inputs: no named parameters. Returns: id, desc, icon, name, +3 more
get_devicesBInspect
获取当前用户家庭(项目)下所有的设备或者获取某个房间下的设备
Inputs: limit, cursor, roomId. Returns: rows, total, isError, pageNum, +3 more
get_groupsAInspect
获取当前用户家庭(项目)下所有的设备组或者获取某个房间下的设备组(设备组:相同设备类型的设备可以组成设备组,例如灯组、开关组灯)
Inputs: limit, cursor, roomId. Returns: rows, total, isError, pageNum, +3 more
get_roomsCInspect
获取当前用户家庭(项目)下所有的房间
Inputs: limit, cursor. Returns: rows, total, isError, pageNum, +3 more
get_scenesCInspect
获取当前用户家庭(项目)下所有的情景(场景、模式)
Inputs: limit, cursor. Returns: rows, total, isError, pageNum, +3 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Yeelight home metadata and guarded management workflows.
Control and query Heiman smart home devices: lights, AC, curtains, climate, logs and scenes.
Control a Loxone Miniserver smart home: lights, blinds, climate, scenes and energy.
Control your existing Philips lights, Sonos speakers, Roborock vacuums and other supported devices through Port OS cloud. Give ChatGPT, Claude and other MCP-compatible assistants access to the devices you connect. Turn off the living room lights, play music on your speakers, adjust the thermostat, run a vacuum in a room, check a camera snapshot or find a connected tracker. Available actions depend on your linked provider accounts and each device’s supported capabilities. Port OS runs in the cloud; no local server is required. You choose the account, device and capability permissions each assistant receives. Device operations require user OAuth; public tool discovery does not grant device access. Port OS is in alpha. Setup: https://portoperatingsystem.com/docs/getting-started/ Support: https://portoperatingsystem.com/contact/
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables control of Yeelight smart lights over local LAN, supporting on/off, brightness, color, temperature, and auto discovery.-
- AlicenseAqualityDmaintenanceEnables discovery and control of Philips Hue lighting devices via a local bridge using the CLIP v2 API, without any cloud dependency.10MIT
- AlicenseAqualityCmaintenanceEnables local network control of Tuya and Smart Life smart home devices without cloud round-trips, including power, brightness, color, and raw datapoint operations.9MIT
- AlicenseAqualityCmaintenanceEnables controlling smart bulbs over IP with power, brightness, and color adjustments, plus real-time state queries and a mock mode for testing.7ISC
Glama MCP Gateway
Add one secure layer between your agents and this server.