AI Huebot MCP

AI HueBot

](https://www.npmjs.com/package/ai-huebot)  ](https://www.npmjs.com/package/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 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 检查配置错误。

许可证

麻省理工学院