AI导哈

LIFX灯光控制终端

一款用于控制LIFX灯光的终端用户界面和MCP服务器，支持LAN和云API后端。

  • by blacktop
  • Go
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 blacktop/lifx

使用说明

lifx

LIFX Light TUI and MCP Server


一个华丽的终端UI和MCP服务器，用于控制LIFX灯。内置魅力（泡泡茶+唇彩），支持局域网和云API后端。

特性

  • 双后端：同时支持LAN协议和LIFX Cloud API。
  • 组和灯：带灯光控制的房间/团体。
  • 亮度、颜色、开尔文：键盘驱动的调整。
  • 场景：通过API后端激活保存的场景。
  • 搜索：按名称过滤灯光。
  • MCP服务器：通过模型上下文协议与AI代理集成。

安装

通过Go：

go install github.com/blacktop/lifx@latest

经由 家酿

brew install blacktop/tap/lifx

后端选择

  • 默认值为 自动：如果 LIFX_API_KEY 已设置，否则使用LAN。
  • 使用强制后端 --backend:
lifx --backend lan
lifx --backend api --api-key "$LIFX_API_KEY"

环境

从获取API密钥 cloud.lifx.com/settings:

export LIFX_API_KEY=...  # Required for API backend and MCP server

配置

通过创建配置文件自定义颜色预设：

平台 位置
macOS ~/Library/Application Support/lifx/config.yaml
Linux ~/.config/lifx/config.yaml
窗户 %AppData%\lifx\config.yaml

带有自定义预设的示例配置：

presets:
  - name: Sunrise
    hue: 35
    saturation: 80
    kelvin: 2500

  - name: Daylight
    hue: 0
    saturation: 0
    kelvin: 5500

  - name: Red
    hue: 0
    saturation: 100
    kelvin: 3500

  - name: Green
    hue: 120
    saturation: 100
    kelvin: 3500

看 docs/config.example.yaml 举一个完整的例子。

键绑定

导航

关键 行动
j / ↓ 向下移动
k / ↑ 向上移动
Tab 切换侧面板

灯光控制

关键 行动
Space 切换电源
0-9 将亮度设置为10-100%
h/l 降低/增加亮度
p 循环颜色预设
w/c 温/冷温度

组控制

关键 行动
a 打开组中的所有灯
x 关闭组中的所有灯

其他

关键 行动
/ 搜索灯
s 场景模式
r 刷新
q 退出

MCP服务器

将lifx作为MCP（模型上下文协议）服务器运行，用于AI代理集成：

lifx mcp

可用工具

工具 说明
list_lights 列出所有灯的当前状态（功率、亮度、颜色）
set_power 打开或关闭特定灯
set_all_power 打开或关闭所有灯
set_brightness 设置亮度级别（0-100）
set_color 设置色调、饱和度、亮度和/或开尔文
list_scenes 列出所有可用场景
activate_scene 按ID激活场景

配置

克劳德代码

claude mcp add lifx -e LIFX_API_KEY=your_api_key -- lifx mcp

Codex CLI

codex mcp add lifx --env LIFX_API_KEY=your_api_key -- lifx mcp

双子座命令行界面

gemini mcp add lifx lifx mcp -e LIFX_API_KEY=your_api_key

克劳德桌面

添加 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "lifx": {
      "command": "lifx",
      "args": ["mcp"],
      "env": {
        "LIFX_API_KEY": "your_api_key"
      }
    }
  }
}

测试

make mcp-test

备注

  • 局域网协议要求灯位于同一网络上。
  • MCP服务器和场景需要LIFX Cloud API(LIFX_API_KEY).

许可证

麻省理工学院版权所有（c）2025 柏油碎石

相关 MCP