LIFX API MCP Server

基本能力

产品定位

LIFX API MCP Server 是一个本地 MCP 服务器，旨在通过自然语言控制 LIFX 设备，提供对 LIFX HTTP API 的访问，支持多种灯光控制和场景管理功能。

核心功能

1. 灯光控制：支持开关、颜色、亮度、效果等设置。
2. 场景管理：支持激活和管理场景。
3. 效果触发：支持多种灯光效果（如呼吸、脉冲、火焰等）。
4. 资源访问：提供灯光、场景等资源的实时数据访问。
5. 提示工具：提供效果创建、故障排查等提示工具。

适用场景

1. 通过自然语言控制家庭或办公环境的灯光。
2. 自动化灯光效果的触发和管理。
3. 场景切换和灯光状态管理。

工具列表

1. list-lights：列出账户中的灯光，支持筛选。
2. set-state：设置选定灯光的状态（开关、颜色、亮度等）。
3. set-states：一次性设置多个灯光的状态。
4. toggle-power：切换选定灯光的开关状态。
5. breathe-effect：执行呼吸效果。
6. pulse-effect：执行脉冲效果。
7. activate-scene：激活指定场景。
8. validate-color：验证颜色字符串并返回其组件。

常见问题解答

1. 如何获取 LIFX API Token？
2. 访问 LIFX Cloud settings page 生成个人访问令牌。
3. 如何配置 API Token？
4. 推荐通过配置文件或环境变量设置，避免在命令行中直接传递。
5. 如何调试？
6. 启动服务器后，查看日志输出以确认服务器是否正常运行。

使用教程

使用依赖

1. Node.js (v18+)： console node --version
2. Docker（可选）： console docker --version

安装教程

1. NPX 安装（推荐）： console npx -y lifx-api-mcp-server@latest
2. Docker 安装： console docker run --rm -i --network=host --pull=always furey/lifx-api-mcp-server
3. Node.js 从源码安装： console git clone https://github.com/furey/lifx-api-mcp-server.git cd lifx-api-mcp-server npm install node lifx-api-mcp-server.js

调试方式

1. 启动服务器后，检查日志输出： [LIFX MCP] LIFX API MCP Server vX.Y.Z starting… [LIFX MCP] Loading config file... [LIFX MCP] LIFX API MCP Server running.
2. 使用 MCP Inspector 调试： console npx -y @modelcontextprotocol/inspector npx -y lifx-api-mcp-server@latest

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。