AI HueBot

AI HueBot

用 AI 控制 Philips Hue 灯具。 设置氛围、保存喜好，并让它随着时间推移了解你的偏好。

一个 MCP 服务，可将任何 AI 客户端（Claude 等）连接到你的 Hue 灯具。只需描述你想要的氛围。

功能

• 氛围模式 -- 说出“舒适的夜晚”或“深度专注”，AI 就会为每盏灯选择颜色和亮度
• 已保存的氛围 -- 每种氛围都会自动保存，之后可以重新应用
• 评分与反馈 -- 为氛围打 1-10 分，让 AI 了解你的喜好
• 收藏 -- 快速访问评分最高的氛围
• 单灯与批量控制 -- 一次设置任意单盏灯或所有灯
• 场景启用 -- 按名称启用任意 Hue 场景
• 智能提示 -- 以友好的方式向新用户介绍反馈系统
• 零配置身份验证 -- 内置 OAuth 凭据，只需在浏览器中授权一次

快速开始

npx ai-huebot

就这么简单。将它添加到你的 AI 客户端（见下文），然后直接提出请求：

“设置舒适的夜晚氛围”

“把卧室灯调成暖橙色，亮度设为 40%”

“给刚才的氛围打 9 分（满分 10 分）”

“应用我评分最高的氛围”

设置

Claude Code

claude mcp add ai-huebot -- npx ai-huebot

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "ai-huebot": {
      "command": "npx",
      "args": ["ai-huebot"]
    }
  }
}

任意 MCP 客户端

• 命令： npx
• 参数： ["ai-huebot"]
• 传输方式： stdio

首次运行

在你的 AI 客户端中调用 hue_auth 工具。它会打开浏览器，让你通过 Philips Hue 完成授权。令牌会保存到 ~/.ai-huebot/tokens.json，并自动刷新。

工具

工具	描述
hue_auth	通过 Philips Hue 授权（浏览器 OAuth）
list_lights	列出所有灯具及其当前状态
set_light	控制单盏灯（开/关、亮度、颜色）
set_all_lights	将所有灯具设为相同状态
set_scene	按名称启用 Hue 场景
set_vibe	描述一种氛围 -- AI 为每盏灯选择颜色（并自动保存）
save_vibe	手动将灯光配置保存为命名氛围
list_saved_vibes	列出所有已保存的氛围
apply_saved_vibe	重新应用已保存的氛围
delete_saved_vibe	删除已保存的氛围
rate_vibe	为氛围打分（1-10 分）和/或留下文字反馈
get_vibe_feedback	查看所有反馈，可按评分筛选
get_favorites	获取评分最高的氛围（评分 >= 7）
get_user_hint	获取一条关于反馈系统的一次性提示
acknowledge_hint	永久关闭该提示

工作原理

身份验证： 通过 Hue Remote API（CLIP v2）进行 OAuth 2.0 授权。内置凭据开箱即用；也可以设置 HUE_CLIENT_ID、HUE_CLIENT_SECRET 和 HUE_CALLBACK_URL 环境变量来使用自己的凭据。

氛围： 描述氛围时，AI 会为每盏灯选择十六进制颜色和亮度。配置会自动以 JSON 格式保存到 ~/.ai-huebot/saved-vibes/，方便你随时重新应用。

反馈循环： 为氛围评分并留下反馈。AI 会利用这些历史记录推荐你可能喜欢的氛围，并避开你不喜欢的氛围。你可以随时查看收藏的氛围（评分 >= 7）。

开发

git clone https://github.com/EthanSK/ai-huebot-mcp.git
cd ai-huebot-mcp
npm install
npm run build   # compile TypeScript
npm run dev     # run with tsx (auto-reload)

故障排除

• CLIP v2 API 返回 403 —— CLIP v2 需要一个包含已加入白名单的网桥用户名的 hue-application-key 标头。hue_auth 流程会自动创建此标头，但如果已存储的用户名丢失或无效，v2 调用将返回 403。此时，服务会自动回退到 v1 API。若要永久解决此问题，请重新运行 hue_auth，重新建立网桥连接。

• 身份验证令牌过期 —— 访问令牌的有效期为 7 天，并会使用已存储的刷新令牌自动刷新。如果刷新失败（例如，访问权限已被撤销），请重新运行 hue_auth 以重新授权。

• 网桥无响应 —— 请确保 Hue 网桥已通电，并与您的设备处于同一网络中。如果路由器重新分配了网桥的本地 IP，该地址可能会发生变化；请在 Hue 应用中查看当前 IP。

• MCP 服务未在 Claude Code 中加载 —— MCP 服务会在会话开始时初始化。如果 AI HueBot 未出现，请运行 /reload-plugins 或重启 Claude Code 会话。运行 /doctor 检查配置错误。

许可证

MIT