Philips Hue MCP Server

by ThomasRohde

Integrations

  • Provides comprehensive control over Philips Hue smart lighting systems, including turning lights on/off, adjusting brightness, changing colors, managing groups, applying scenes, using activity presets, and creating lighting effects.

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

インストール

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

初実行

  1. サーバーを実行します。
python hue_server.py
  1. プロンプトが表示されたら、Hueブリッジのリンクボタンを押して接続を承認します。
  2. 接続の詳細は、将来使用するために~/.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_rgbRGB値を使用してライトの色を設定する
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が接続すると、以下のようになります。

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

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

貢献

貢献大歓迎!お気軽にどうぞ:

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

ライセンス

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

-
security - not tested
F
license - not found
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

Claude のような AI アシスタントが自然言語コマンドを通じて Philips Hue スマート照明システムを制御できるようにするモデル コンテキスト プロトコル インターフェイス。

  1. 目次
    1. 概要
      1. 特徴
        1. クイックスタート
          1. 設定
            1. 前提条件
            2. インストール
            3. 初実行
          2. クロードと一緒に使う
            1. オプション1: Claude Desktopにインストールする
            2. オプション2: MCP Inspectorでテストする
          3. APIリファレンス
            1. リソース
            2. ツール
            3. プロンプト
            1. 単一ライトの制御
            2. グループでの作業
            3. シーンの作成
          4. 詳細オプション
            1. トラブルシューティング
              1. 仕組み
                1. 貢献
                  1. ライセンス

                    Related MCP Servers

                    • A
                      security
                      A
                      license
                      A
                      quality
                      An enhanced Model Context Protocol server that enables AI assistants to interact with ClickUp workspaces, supporting task relationships, comments, checklists, and workspace management through natural language.
                      Last updated -
                      40
                      376
                      TypeScript
                      MIT License
                    • -
                      security
                      A
                      license
                      -
                      quality
                      A Model Context Protocol server that integrates with Home Assistant to provide smart home control capabilities through natural language, supporting devices like lights, climate systems, locks, alarms, and humidifiers.
                      Last updated -
                      Python
                      MIT License
                      • Apple
                    • -
                      security
                      A
                      license
                      -
                      quality
                      A Model Context Protocol (MCP) integration that allows AI assistants to control Home Assistant devices by searching for entities and controlling devices through natural language commands.
                      Last updated -
                      10
                      Python
                      MIT License
                      • Linux
                      • Apple
                    • -
                      security
                      A
                      license
                      -
                      quality
                      A Model Context Protocol server that enables AI assistants like Claude to interact directly with Home Assistant, allowing them to query device states, control smart home entities, and perform automation tasks.
                      Last updated -
                      15
                      Python
                      MIT License
                      • Apple
                      • Linux

                    View all related MCP servers

                    ID: qjq6xe8p1x