Philips Hue MCP サーバー

Philips Hue スマート照明システムを制御するための強力なモデルコンテキストプロトコル (MCP) インターフェイス。

概要

このサーバーは、モデルコンテキストプロトコル（MCP）を活用し、ClaudeなどのAIアシスタントとPhilips Hue照明システムをシームレスに統合します。これにより、自然言語でスマートライトを制御したり、詳細な照明情報にアクセスしたり、標準化されたAI対応インターフェースを通じて高度な照明設定を作成したりできるようになります。

特徴

完全な照明コントロール：オン/オフ、明るさの調整、色の変更、色温度の設定
包括的なグループ管理：複数のライトをまとめて制御し、カスタムグループを作成します
シーン処理: 既存のシーンを適用し、カスタム照明シーンを素早く作成します
アクティビティベースのプリセット: 読書、リラクゼーション、集中などのための既成設定
特殊効果: カラーループなどのダイナミックな照明効果にアクセスします
自然言語制御：会話による照明制御のための特別なプロンプト
安全なローカル統合: ローカルネットワーク上の Hue ブリッジに直接接続します

クイックスタート

# Install dependencies pip install phue mcp # Run the server python hue_server.py # Install in Claude Desktop mcp install hue_server.py --name "My Hue Lights"

次に、Claude で次のように始めます。「Philips Hue のライトを操作したいのですが、利用できるライトを教えてもらえますか?」

設定

前提条件

Python 3.9以上
ローカルネットワーク上のPhilips Hueブリッジ
Philips Hue ライトをブリッジとペアリング

インストール

このリポジトリをクローンするか、 hue_server.pyファイルをダウンロードしてください。
必要な依存関係をインストールします。

pip install phue mcp

初実行

サーバーを実行します。

python hue_server.py

プロンプトが表示されたら、Hueブリッジのリンクボタンを押して接続を承認します。
接続の詳細は、将来使用するために~/.hue-mcp/config.jsonに保存されます。

クロードと一緒に使う

オプション1: Claude Desktopにインストールする

Claude Desktop がインストールされている場合:

mcp install hue_server.py --name "Philips Hue Controller"

オプション2: MCP Inspectorでテストする

開発とテストの場合:

mcp dev hue_server.py

APIリファレンス

リソース

リソース	説明
`hue://lights`	すべてのライトに関する情報
`hue://lights/{light_id}`	特定のライトに関する詳細情報
`hue://groups`	すべてのライトグループに関する情報
`hue://groups/{group_id}`	特定のグループに関する情報
`hue://scenes`	すべてのシーンに関する情報

ツール

道具	説明
`get_all_lights`	すべてのライトに関する情報を取得する
`get_light`	特定のライトの詳細情報を取得する
`get_all_groups`	すべてのライトグループに関する情報を取得する
`get_group`	特定のグループに関する情報を取得する
`get_all_scenes`	すべてのシーンの情報を取得する
`turn_on_light`	特定のライトを点灯する
`turn_off_light`	特定のライトを消す
`set_brightness`	ライトの明るさを調整する（0～254）
`set_color_rgb`	RGB値を使用してライトの色を設定する
`set_color_temperature`	ライトの色温度を設定する（2000～6500K）
`turn_on_group`	グループ内のすべてのライトをオンにする
`turn_off_group`	グループ内のすべてのライトを消す
`set_group_brightness`	グループの明るさを調整する（0～254）
`set_group_color_rgb`	グループ内のすべてのライトの色を設定する
`set_scene`	グループにシーンを適用する
`find_light_by_name`	名前でライトを検索する
`create_group`	新しいライトグループを作成する
`quick_scene`	カスタム設定を適用してシーンを作成する
`refresh_lights`	ライト情報キャッシュを更新する
`set_color_preset`	ライトにカラープリセットを適用する
`set_group_color_preset`	グループにカラープリセットを適用する
`alert_light`	ライトを一瞬点滅させる
`set_light_effect`	カラーループなどのダイナミックエフェクトを設定する

プロンプト

プロンプト	説明
`control_lights`	自然言語による照明制御
`create_mood`	アクティビティに合わせてムード照明を設定する
`light_schedule`	スケジュールオプションについて学ぶ

例

単一ライトの制御

# Turn on a light turn_on_light(1) # Set a light to 50% brightness set_brightness(1, 127) # Change a light color to purple set_color_rgb(1, 128, 0, 128) # Set reading mode set_color_preset(1, "reading")

グループでの作業

# Turn off all lights in living room (group 2) turn_off_group(2) # Create a new group create_group("Bedroom", [3, 4, 5]) # Set all kitchen lights to energizing mode set_group_color_preset(3, "energize")

シーンの作成

# Apply an existing scene set_scene(2, "abc123") # Group 2, scene ID abc123 # Create a quick relaxing scene for the living room quick_scene("Evening Relaxation", group_id=2, rgb=[255, 147, 41], brightness=120)

詳細オプション

カスタム設定でサーバーを実行します。

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

トラブルシューティング

ブリッジが見つかりません: 自動検出が機能しない場合は、次の 2 つのオプションがあります。
1. スクリプト内のBRIDGE_IP変数をブリッジのIPアドレスで手動で編集します。
2. 手動で設定ファイルを作成します。
  # Create the config directory mkdir -p ~/.hue-mcp # Create a config.json file with your bridge IP echo '{"bridge_ip": "192.168.1.x"}' > ~/.hue-mcp/config.json
  「192.168.1.x」を実際のHueブリッジのIPアドレスに置き換えます。
接続の問題: ~/.hue-mcp/config.jsonを削除し、サーバーを再起動して再認証してください
ライト制御が機能しない: refresh_lightsツールを使用してライト情報キャッシュを更新します
グループまたはシーンが表示されない: ブリッジとサーバーを再起動してすべてのデータを同期してください

仕組み

このサーバーは、 phue Pythonライブラリを使用してPhilips Hueブリッジに接続し、モデルコンテキストプロトコルを通じて機能を公開します。ClaudeのようなAIが接続すると、以下のようになります。

サーバーは保存された資格情報を使用してブリッジを認証します
照明設定を説明するリソースを提供します
クロードが照明を制御するために使用できるツールを公開します
クロードがライトの操作方法を理解するのに役立つプロンプトを提供します

セキュリティとプライバシーのため、Hue システムとのすべての通信はネットワーク内でローカルに行われます。

貢献

貢献大歓迎！お気軽にどうぞ：

問題追跡システムでバグを報告したり機能を提案したりしてください
改善点を記載したプルリクエストを送信する
スマートホームのセットアップでこれをどのように使用しているかの例を共有してください

ライセンス

このプロジェクトは MIT ライセンスの下で利用可能です。

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Philips Hue MCP Server