Hue Lights

🚀 飞利浦Hue MCP服务器

飞利浦Hue MCP服务器是一款用于控制和管理飞利浦Hue智能灯泡的工具。它借助MCP协议与飞利浦Hue桥接器通信，让人工智能（如Claude）能通过自然语言处理来控制灯光，为智能照明控制带来了极大的便利。

🚀 快速开始

飞利浦Hue MCP（模型上下文协议）服务器可用于控制和管理飞利浦Hue智能灯泡。它通过MCP协议与飞利浦Hue桥接器通信，允许人工智能（如Claude）通过自然语言处理来控制灯光。

✨ 主要特性

• 资源提供：定义设备、灯具、组和场景等资源。
• 工具暴露：提供多种操作工具，如开关灯、调节亮度、更改颜色、设置情景模式等。
• 提示交互：内置提示语帮助AI理解如何与灯光系统互动。

💻 使用示例

基础用法

控制单个灯具

# 打开一个灯具
turn_on_light(1)

# 调节亮度到50%
set_brightness(1, 127)

# 设置颜色为紫色
set_color_rgb(1, 128, 0, 128)

# 应用阅读模式
set_color_preset(1, "reading")

控制组

# 关闭客厅灯具组（组ID=2）
turn_off_group(2)

# 创建新组
create_group("卧室", [3, 4, 5])

# 设置厨房灯具为活力模式
set_group_color_preset(3, "energize")

创建情景模式

# 应用已配置的情景模式
set_scene(2, "abc123")  # 组ID=2，情景模式ID=abc123

# 创建快速放松情景模式
quick_scene("夜晚放松", group_id=2, rgb=[255, 147, 41], brightness=120)

🔧 技术细节

高级选项

通过命令行参数自定义服务器配置：

python hue_server.py --host 0.0.0.0 --port 8888 --log-level debug

• --host：指定服务器绑定的IP地址（默认为本地IP）
• --port：指定服务器监听的端口（默认为8090）
• --log-level：设置日志级别（debug、info、warning等）

如何工作

1. 认证连接：使用飞利浦Hue协议与桥接器建立安全连接。
2. 资源提供：定义灯具、组和情景模式等资源供AI调用。
3. 工具交互：通过MCP协议暴露控制工具，使AI能够执行灯光操作。
4. 自然语言处理：内置提示语帮助AI理解用户的意图并转换为具体的操作指令。

🛠️ 故障排除

1. 桥接器未发现：

   • 手动编辑配置文件，将BRIDGE_IP变量设为你的Hue桥接器IP地址。
   • 创建一个空白的配置文件并指定桥接器IP：

     mkdir -p ~/.hue-mcp
     echo '{"bridge_ip": "192.168.1.x"}' > ~/.hue-mcp/config.json
     

     其中192.168.1.x替换为你的实际桥接器IP地址。

2. 连接问题：

   • 删除配置文件并重新启动服务器以重新认证：

     rm ~/.hue-mcp/config.json
     

3. 灯具控制失效：

   • 使用refresh_lights工具更新灯具信息缓存。

4. 组或情景模式未显示：

   • 重启桥接器和服务器以同步数据。

👥 贡献

欢迎提交问题和建议！

• 仓库地址：https://github.com/your-repository
• 提交Issue或Pull Request以改进功能。

📄 许可证

本项目遵循MIT许可证：

版权所有 (c) 年份，作者姓名
许可根据 MIT 许可证分发。

允许个人和商业用途。在分发派生作品时，必须保留版权声明、许可证信息和免责声明。