Skip to main content
Glama

Yeelight IoT MCP Server

Server Details

Yeelight device discovery, state, control, and scene execution.

Ownership verified
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

A3.5/5.0

Scored across 8 tools

Disambiguation5/5

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.

Naming Consistency4/5

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.

Tool Count5/5

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.

Completeness3/5

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 tools
control_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

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables discovery and control of Philips Hue lighting devices via a local bridge using the CLIP v2 API, without any cloud dependency.
      10
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables local network control of Tuya and Smart Life smart home devices without cloud round-trips, including power, brightness, color, and raw datapoint operations.
      9
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.