🚀 LIFX局域网MCP项目

本项目是一个用于控制LIFX智能灯具的工具集，借助模型上下文协议（Model Context Protocol, MCP）与LIFX灯具进行交互。它提供了查询灯具状态、调整灯光颜色、开关控制等实用功能。

🚀 快速开始

开发环境准备

• Node.js
• TypeScript
• LIFX灯具接入局域网

克隆仓库

git clone https://github.com/simon-duchastel/lifx-lan-mcp.git
cd lifx-lan-mcp

安装依赖

npm install

构建项目

npm run build

✨ 主要特性

• 状态查询：可获取指定LIFX灯具的状态信息，如颜色、开关状态、分组及位置等。
• 颜色调整：支持调整指定LIFX灯具的颜色参数，还能实现渐变过渡效果。
• 开关控制：能开启或关闭指定LIFX灯具，开启时可选配颜色调整，关闭时支持渐变关闭效果。

💻 使用示例

基础用法

查询灯具状态

# 调用 lifx_lan_get_light_status 工具查询灯具状态
# 假设需要查询标签为 ["light1", "light2"] 的灯具状态
labels = ["light1", "light2"]
# 这里假设存在调用工具的函数
status = lifx_lan_get_light_status(labels)
print(status)

设置灯具颜色

# 调用 lifx_lan_set_light_color 工具设置灯具颜色
labels = ["light1"]
color = {
    "hue": 0.5,
    "saturation": 0.8,
    "brightness": 0.9,
    "kelvin": 4000
}
duration = 2000  # 过渡持续时间为 2000 毫秒
# 这里假设存在调用工具的函数
lifx_lan_set_light_color(labels, color, duration)

打开灯具

# 调用 lifx_lan_turn_on_lights 工具打开灯具
labels = ["light2"]
color = {
    "hue": 0.2,
    "saturation": 0.7,
    "brightness": 0.8
}
duration = 1500  # 过渡持续时间为 1500 毫秒
# 这里假设存在调用工具的函数
lifx_lan_turn_on_lights(labels, color, duration)

关闭灯具

# 调用 lifx_lan_turn_off_lights 工具关闭灯具
labels = ["light1"]
duration = 1000  # 过渡持续时间为 1000 毫秒
# 这里假设存在调用工具的函数
lifx_lan_turn_off_lights(labels, duration)

📚 详细文档

代码结构

MCP定义位于index.ts，包含所有可供大语言模型调用的工具。API接口实现于src/目录中。

功能工具详情

1. 查询灯具状态

工具名称: lifx_lan_get_light_status
功能描述: 获取指定LIFX灯具的状态信息，包括颜色、开关状态、分组及位置等。

输入参数:

• labels (string[]): 需要查询的灯具标签列表

2. 设置灯具颜色

工具名称: lifx_lan_set_light_color
功能描述: 调整指定LIFX灯具的颜色参数，支持渐变过渡效果。

输入参数:

• labels (string[]): 需要调整的灯具标签列表
• color (object): 颜色配置参数
  • hue (number): 色调值（范围：0.0 - 1.0）
  • saturation (number): 饱和度值（范围：0.0 - 1.0）
  • brightness (number): 明亮度值（范围：0.0 - 1.0）
  • kelvin (number, optional): 色温值（单位：开尔文，范围：1500 - 9000，默认值：3500）
• duration (number, optional): 过渡持续时间（单位：毫秒）

3. 打开灯具

工具名称: lifx_lan_turn_on_lights
功能描述: 开启指定LIFX灯具，可选配颜色调整。

输入参数:

• labels (string[]): 需要开启的灯具标签列表
• color (object, optional): 颜色配置参数（可选）
  • hue (number, optional): 色调值
  • saturation (number, optional): 饱和度值
  • brightness (number, optional): 明亮度值
  • kelvin (number, optional): 色温值
• duration (number, optional): 过渡持续时间

4. 关闭灯具

工具名称: lifx_lan_turn_off_lights
功能描述: 关闭指定LIFX灯具，支持渐变关闭效果。

输入参数:

• labels (string[]): 需要关闭的灯具标签列表
• duration (number, optional): 过渡持续时间

🔧 技术细节

MCP定义位于index.ts，包含所有可供大语言模型调用的工具。API接口实现于src/目录中，通过这些接口实现与LIFX灯具的交互。

📄 许可证

本项目采用MIT许可证，具体内容详见LICENSE文件。

📞 联系方式

如有任何问题或建议，欢迎通过以下方式联系：

• 邮件: lifx-lan-mcp@duchastel.com
• GitHub ISSUE: https://github.com/simon-duchastel/lifx-lan-mcp/issues

如果该项目对您有帮助，可以考虑通过Buy Me a Coffee支持作者。

⚠️ 重要提示

使用HTTP服务器模式时，请确保网络环境安全，防止未授权访问。

💡 使用建议

项目基于Node.js开发，需提前安装相关依赖项。