AI HueBot

AI HueBot

AI で Philips Hue ライトを操作できます。 雰囲気を設定したり、お気に入りを保存したり、時間とともに好みを学習させたりできます。

あらゆる AI クライアント（Claude など）を Hue ライトに接続する MCP サーバーです。希望する雰囲気を説明するだけです。

機能

• 雰囲気モード -- 「居心地のよい夜」や「深い集中」と伝えると、AI がすべてのライトの色と明るさを選びます
• 雰囲気の保存 -- 雰囲気はすべて自動保存され、後から再適用できます
• 評価とフィードバック -- 雰囲気を 1～10 で評価すると、AI が好みを学習します
• お気に入り -- 評価の高い雰囲気にすばやくアクセスできます
• 個別および一括操作 -- 任意のライト、またはすべてのライトを一度に設定できます
• シーンの有効化 -- 名前を指定して任意の Hue シーンを実行できます
• スマートヒント -- 新規ユーザーにフィードバック機能をさりげなく紹介します
• 設定不要の認証 -- OAuth 認証情報が組み込まれているため、ブラウザーで一度認証するだけです

クイックスタート

npx ai-huebot

これだけです。AI クライアントに追加して（以下を参照）、次のように尋ねてください。

「居心地のよい夜の雰囲気にして」

「寝室を暖かいオレンジ色にして、明るさを 40% にして」

「その雰囲気を 10 点満点中 9 点で評価して」

「最も評価の高い雰囲気を適用して」

セットアップ

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	1 つのライトを操作します（オン／オフ、明るさ、色）
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 が各ライトの 16 進数カラーコードと明るさを選びます。設定は 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 アドレスが再割り当てされると、ブリッジのローカル IP が変わることがあります。現在の IP は Hue アプリで確認してください。

• Claude Code で MCP サーバーが読み込まれない -- MCP サーバーはセッション開始時に初期化されます。AI HueBot が表示されない場合は、/reload-plugins を実行するか、Claude Code のセッションを再起動してください。/doctor を実行すると、設定エラーを確認できます。

ライセンス

MIT