Hue Lights

🚀 フィリップスHue MCPサーバー

フィリップスHue MCPサーバーは、フィリップスHueスマートライトを制御および管理するためのツールです。MCPプロトコルを通じてフィリップスHueブリッジと通信し、ClaudeなどのAIが自然言語処理によってライトを制御できるようにします。

🚀 クイックスタート

このサーバーを使用することで、AIが自然言語でフィリップスHueライトを制御できるようになります。以下のセクションで詳細な機能、使用例、設定方法などを説明します。

✨ 主な機能

• リソース提供：デバイス、灯具、グループ、シーンなどのリソースを定義します。
• ツール公開：ライトのオン/オフ、明るさの調整、色の変更、シーンモードの設定など、様々な操作ツールを提供します。
• プロンプト対話：AIがライトシステムとどのように対話するかを理解するのを助けるプロンプトが組み込まれています。

💻 使用例

基本的な使用法

単一の灯具を制御する

# 灯具をオンにする
turn_on_light(1)

# 明るさを50%に調整する
set_brightness(1, 127)

# 色を紫色に設定する
set_color_rgb(1, 128, 0, 128)

# 読書モードを適用する
set_color_preset(1, "reading")

グループを制御する

# リビングの灯具グループをオフにする（グループID=2）
turn_off_group(2)

# 新しいグループを作成する
create_group("卧室", [3, 4, 5])

# キッチンの灯具を活力モードに設定する
set_group_color_preset(3, "energize")

シーンモードを作成する

# 設定済みのシーンモードを適用する
set_scene(2, "abc123")  # グループID=2，シーンモードID=abc123

# 快速放松シーンモードを作成する
quick_scene("夜晚放松", group_id=2, rgb=[255, 147, 41], brightness=120)

🔧 高度な使用法

サーバー設定のカスタマイズ

コマンドライン引数を使用してサーバーの設定をカスタマイズできます。

python hue_server.py --host 0.0.0.0 --port 8888 --log-level debug

• --host：サーバーがバインドするIPアドレスを指定します（デフォルトはローカルIP）。
• --port：サーバーがリッスンするポートを指定します（デフォルトは8090）。
• --log-level：ログレベルを設定します（debug、info、warningなど）。

🛠️ トラブルシューティング

ブリッジが見つからない場合

• 設定ファイルを手動で編集し、BRIDGE_IP変数をあなたのHueブリッジのIPアドレスに設定します。
• 空白の設定ファイルを作成し、ブリッジのIPアドレスを指定します。

mkdir -p ~/.hue-mcp
echo '{"bridge_ip": "192.168.1.x"}' > ~/.hue-mcp/config.json

192.168.1.xをあなたの実際のブリッジのIPアドレスに置き換えてください。

接続問題が発生した場合

• 設定ファイルを削除し、サーバーを再起動して再認証を行います。

rm ~/.hue-mcp/config.json

灯具の制御が機能しない場合

• refresh_lightsツールを使用して灯具情報のキャッシュを更新します。

グループまたはシーンモードが表示されない場合

• ブリッジとサーバーを再起動してデータを同期します。

📚 仕組みの説明

1. 認証接続：フィリップスHueプロトコルを使用してブリッジと安全な接続を確立します。
2. リソース提供：灯具、グループ、シーンモードなどのリソースを定義し、AIが呼び出せるようにします。
3. ツール対話：MCPプロトコルを通じて制御ツールを公開し、AIがライト操作を実行できるようにします。
4. 自然言語処理：組み込まれたプロンプトにより、AIがユーザーの意図を理解し、具体的な操作コマンドに変換できるようにします。

🤝 コントリビューション

問題や提案の投稿を歓迎します！

• リポジトリのURL：https://github.com/your-repository
• 機能を改善するためにIssueまたはPull Requestを投稿してください。

📄 ライセンス

このプロジェクトはMITライセンスに基づいています。

Copyright (c) 年份，作者姓名
本ソフトウェアはMITライセンスの下で配布されます。

個人および商用利用が許可されています。派生作品を配布する際には、著作権表示、ライセンス情報、免責事項を保持する必要があります。