
LIFX LAN MCP

2025.04.12
0
JavaScript智能灯光控制家庭自动化其它
LIFX LAN MCP 是一个基于 Model Context Protocol (MCP) 的服务,允许 LLM 通过局域网 (LAN) 控制 LIFX 灯光,无需云连接。该服务必须在与 LIFX 灯光相同的 WiFi 网络上运行。
View on GitHub
Overview
基本能力
产品定位
LIFX LAN MCP 是一个用于控制 LIFX 灯光的 MCP 服务器,通过本地网络实现灯光的控制和管理。
核心功能
- 列出网络上所有可用的 LIFX 灯光
- 获取灯光的当前状态(颜色、开关状态、标签等)
- 控制灯光的开关
- 改变灯光的颜色
- 本地网络操作(无需云服务)
适用场景
- 家庭自动化
- 智能灯光控制
- 本地网络环境下的灯光管理
工具列表
- lifx_lan_list_lights
- 功能:列出用户局域网 (LAN) 上所有可用的 LIFX 灯光
- 输入:无
-
输出:包含灯光标签、组和位置等信息的列表
-
lifx_lan_get_lights_state
- 功能:获取一个或多个 LIFX 灯光的当前状态
- 输入:
labels
(字符串数组) -
输出:灯光的颜色、开关状态、组和位置等信息
-
lifx_lan_set_lights_color
- 功能:设置一个或多个 LIFX 灯光的颜色
-
输入:
labels
(字符串数组)、color
(对象,包含色调、饱和度、亮度和色温等)、duration
(可选,过渡时间) -
lifx_lan_turn_on_lights
- 功能:打开一个或多个 LIFX 灯光,可选指定颜色
-
输入:
labels
(字符串数组)、color
(可选,颜色对象)、duration
(可选,过渡时间) -
lifx_lan_turn_off_lights
- 功能:关闭一个或多个 LIFX 灯光
- 输入:
labels
(字符串数组)、duration
(可选,过渡时间)
常见问题解答
- Q: 为什么 MCP 服务器必须在与 LIFX 灯光相同的 WiFi 网络上运行? A: 因为该服务通过本地网络控制灯光,不依赖云服务。
使用教程
使用依赖
- Node.js
- TypeScript
- LIFX 灯光(必须在同一局域网)
安装教程
-
通过 NPX 安装: 在 LLM MCP 配置文件中添加以下内容(例如 Claude Desktop 的
claude_desktop_config.json
):json { "mcpServers": { "lifx-lan-mcp": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-brave-search" ] } } }
-
从源代码构建:
bash git clone https://github.com/simon-duchastel/lifx-lan-mcp.git cd lifx-lan-mcp npm install npm run build
调试方式
- 运行
npm run prepare
编译项目(生成dist/index.js
) - 检查灯光是否在同一网络
- 确保 Node.js 和 TypeScript 已正确安装