智能灯光控制服务

AI HueBot是一款通过AI智能控制Philips Hue灯光的服务,能够根据用户描述的情绪自动调整灯光颜色和亮度,并学习用户偏好。

  • by EthanSK
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 EthanSK/ai-huebot-mcp

使用说明

AI HueBot

使用AI控制飞利浦秀灯光。 设置氛围,保存收藏夹,让它随着时间的推移了解你的偏好。

一 主控程序 将任何AI客户端(Claude等)连接到Hue灯光的服务器。描述一下你想要的心情。

特性

  • Vibe模式 --比如“舒适的夜晚”或“深度聚焦”,人工智能会为每盏灯挑选颜色和亮度
  • 保存的氛围 --每个氛围都是自动保存的,以后可以重新应用
  • 评分和反馈 --对震动进行1-10的评分,以便AI学习你喜欢的东西
  • 收藏夹 --快速访问您的顶级氛围
  • 个人和批量控制 --一次设置任何灯光或所有灯光
  • 场景激活 --按名称触发任何色调场景
  • 智能提示 --温和地向新用户介绍反馈系统
  • 零配置身份验证 --内置OAuth凭据,只需在浏览器中授权一次

快速开始

npx ai-huebot

就是这样。将其添加到您的AI客户端(见下文),然后问:

“营造温馨的夜晚氛围”

“让卧室变成40%的暖橙色”

“给这种氛围打9分(满分10分)”

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

设置

克劳德代码

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

克劳德桌面版

添加 ~/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
  • Args: ["ai-huebot"]
  • 运输: 标准

首映

打电话给 hue_auth 您的AI客户端提供的工具。它打开您的浏览器以授权飞利浦秀。令牌保存到 ~/.ai-huebot/tokens.json 并自动刷新。

工具

工具 说明
hue_auth 使用飞利浦秀(浏览器OAuth)授权
list_lights 列出所有当前状态的灯
set_light 控制单个灯(开/关、亮度、颜色)
set_all_lights 将所有灯光设置为相同状态
set_scene 按名称激活色调场景
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 env变量使用你自己的。

共鸣: 当你描述一种氛围时,AI会为每盏灯选择十六进制颜色和亮度。配置会自动保存到 ~/.ai-huebot/saved-vibes/ JSON格式,因此您可以随时重新应用它。

反馈回路: 评价氛围并留下反馈。人工智能使用此历史记录来建议你喜欢的氛围,避免你不喜欢的氛围。收藏夹(评分>=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 flow会自动创建此消息,但如果存储的用户名丢失或无效,v2调用将返回403。在这种情况下,服务器会自动返回到v1 API。要永久修复,请重新运行 hue_auth 以重建桥梁连接。

  • 身份验证令牌过期 --访问令牌持续7天,并使用存储的刷新令牌自动刷新。如果刷新失败(例如撤销访问),请重新运行 hue_auth 重新授权。

  • 桥没有响应 --确保您的Hue网桥已通电,并且与您的机器位于同一网络上。如果路由器重新分配网桥,网桥的本地IP可能会发生变化——请检查Hue应用程序中的当前IP。

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

许可证

麻省理工学院