Philips Hue MCP サーバー

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

目次

• Philips Hue MCP サーバー

  • 概要

  • 特徴

  • クイックスタート

  • 設定

    • 前提条件

    • インストール

    • 初実行

  • クロードと一緒に使う

  • APIリファレンス

    • リソース

    • ツール

    • プロンプト

  • 例

    • 単一ライトの制御

    • グループでの作業

    • シーンの作成

  • 詳細オプション

  • トラブルシューティング

  • 仕組み

  • 貢献

  • ライセンス

Related MCP server: Hass-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 ライトをブリッジとペアリング

インストール

1. このリポジトリをクローンするか、 hue_server.pyファイルをダウンロードしてください。

2. 必要な依存関係をインストールします。

pip install phue mcp

初実行

1. サーバーを実行します。

python hue_server.py

2. プロンプトが表示されたら、Hueブリッジのリンクボタンを押して接続を承認します。

3. 接続の詳細は、将来使用するために~/.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リファレンス

リソース

ツール

プロンプト

例

単一ライトの制御

# 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が接続すると、以下のようになります。

1. サーバーは保存された資格情報を使用してブリッジを認証します

2. 照明設定を説明するリソースを提供します

3. クロードが照明を制御するために使用できるツールを公開します

4. クロードがライトの操作方法を理解するのに役立つプロンプトを提供します

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

貢献

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

• 問題追跡システムでバグを報告したり機能を提案したりしてください

• 改善点を記載したプルリクエストを送信する

• スマートホームのセットアップでこれをどのように使用しているかの例を共有してください

ライセンス

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