Philips Hue MCP Server
2025.03.26
0
Python智能照明控制AI 语音控制娱乐功能
Philips Hue MCP Server 是一个基于 Model Context Protocol (MCP) 的强大接口，专门用于控制 Philips Hue 智能照明系统。它通过标准化的 AI 友好接口，实现了与 AI 助手（如 Claude）的无缝集成，使用户能够通过自然语言控制智能灯光、访问详细的照明信息以及创建高级照明设置。
View on GitHub
Overview
基本能力
产品定位
Philips Hue MCP Server 是一个智能照明控制系统，通过 MCP 协议与 AI 助手集成，提供自然语言控制智能灯光的能力。
核心功能
- 灯光控制：开关、调节亮度、改变颜色、设置色温
- 群组管理：控制多个灯光、创建自定义群组
- 场景处理：应用现有场景、创建快速自定义照明场景
- 活动预设：提供阅读、放松、专注等预设照明模式
- 特效功能：支持动态照明效果如颜色循环
- 自然语言控制：通过对话控制灯光的专用提示
- 安全本地集成：直接连接到本地网络中的 Hue 桥接器
适用场景
- 家庭智能照明控制
- 通过 AI 助手进行语音控制
- 创建个性化照明场景
- 根据活动自动调整照明
工具列表
| 工具 | 描述 |
|---|---|
get_all_lights |
获取所有灯光信息 |
get_light |
获取特定灯光的详细信息 |
get_all_groups |
获取所有灯光群组信息 |
get_group |
获取特定群组信息 |
get_all_scenes |
获取所有场景信息 |
turn_on_light |
打开特定灯光 |
turn_off_light |
关闭特定灯光 |
set_brightness |
调节灯光亮度 (0-254) |
set_color_rgb |
使用 RGB 值设置灯光颜色 |
set_color_temperature |
设置灯光色温 (2000-6500K) |
turn_on_group |
打开群组中所有灯光 |
turn_off_group |
关闭群组中所有灯光 |
set_group_brightness |
调节群组亮度 (0-254) |
set_group_color_rgb |
为群组中所有灯光设置颜色 |
set_scene |
将场景应用到群组 |
find_light_by_name |
按名称搜索灯光 |
create_group |
创建新灯光群组 |
quick_scene |
应用自定义设置创建场景 |
refresh_lights |
更新灯光信息缓存 |
set_color_preset |
将颜色预设应用到灯光 |
set_group_color_preset |
将颜色预设应用到群组 |
alert_light |
让灯光短暂闪烁 |
set_light_effect |
设置动态效果如颜色循环 |
常见问题解答
- 桥接器未找到：可以手动编辑脚本中的
BRIDGE_IP变量或创建配置文件 - 连接问题：删除
~/.hue-mcp/config.json并重启服务器重新认证 - 灯光控制无效：使用
refresh_lights工具更新灯光信息缓存 - 群组或场景不显示：重启桥接器和服务器以同步所有数据
使用教程
使用依赖
pip install phue mcp
安装教程
- 克隆仓库或下载
hue_server.py文件 - 安装依赖：
pip install phue mcp
- 运行服务器：
python hue_server.py
- 按照提示按下 Hue 桥接器上的链接按钮进行授权
调试方式
- 使用 Claude Desktop 安装：
mcp install hue_server.py --name "Philips Hue Controller"
- 使用 MCP Inspector 测试：
mcp dev hue_server.py
- 自定义运行设置：
python hue_server.py --host 0.0.0.0 --port 8888 --log-level debug