LIFX MCP Server

LIFX MCP 服务器

基于 TypeScript 的MCP服务器，用于通过官方 LIFX HTTP API 控制LIFX智能灯。

特征

• 使用 MCP 工具控制 LIFX 灯
• 设置状态、切换和应用效果（呼吸、移动、变形、火焰）
• 激活场景并解析颜色字符串
• 采用FastMCP构建，易于集成

入门

先决条件

• Node.js（建议使用 v16+）
• LIFX 云 API 令牌（在此处获取）
• 与 MCP 兼容的客户端（例如 VS Code）

安装

建造

跑步

您可以直接启动服务器：

或者使用 MCP 工具（推荐）：

与 VS Code 一起使用

为了快速安装，请使用本自述文件顶部的一键安装按钮之一。

如需手动安装，请将以下 JSON 块添加到 VS Code 中的“用户设置 (JSON)”文件中。您可以按下Ctrl + Shift + P并输入Preferences: Open User Settings (JSON)来完成此操作。

或者，您可以将其添加到工作区中名为.vscode/mcp.json的文件中。这样您就可以与其他人共享该配置。

请注意.vscode/mcp.json文件中不需要mcp键。

配置

服务器需要 LIFX API 令牌。您可以通过以下方式提供：

• .env文件：
  LIFX_TOKEN=your_lifx_token_here
• 或者通过 VS Code MCP 扩展提示（参见.vscode/mcp.json ）。

用法

该服务器公开以下 MCP 工具：

• get-lights ：通过选择器获取灯光状态
• set-state ：设置状态（电源、颜色、亮度等）
• set-states ：一次设置多个状态
• set-state-delta ：应用增量更改
• toggle-lights ：切换电源
• breathe-effect 、 move-effect 、 morph-effect 、 flame-effect ：运行效果
• get-scenes 、 activate-scene ：场景管理
• parse-color ：解析颜色字符串

示例：切换灯光

发展

• TypeScript 源码： src/
• 构建输出： build/
• 类型和模式： src/types.ts
• FastMCP 服务器： src/index.ts

脚本

• npm run build – 编译 TypeScript 以build/
• npm start – 运行已编译的服务器
• npm run dev – 使用 tsx 运行进行开发
• npm run inspect – 使用 FastMCP Inspector 检查

API 参考

有关完整的 LIFX API 详细信息和颜色格式，请参阅.docs/lifxapi.md 。

执照

国际学习中心

本项目与 LIFX 无关。使用风险自负。