Skip to main content
Glama

Philips Hue MCP Server

by ThomasRohde

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

  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
                      Enables control of Philips Hue lights through Claude and other LLM interfaces using the OpenHue CLI.
                      Last updated -
                      6
                      9
                      MIT License
                      • Apple
                      • Linux
                    • A
                      security
                      A
                      license
                      A
                      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 -
                      12
                      197
                      MIT License
                      • Apple
                      • Linux
                    • A
                      security
                      A
                      license
                      A
                      quality
                      A Model Context Protocol service that enables remote management and control of NodeMCU/ESP8266 IoT devices with AI assistant integration through Claude Desktop.
                      Last updated -
                      4
                      1
                      MIT License
                    • -
                      security
                      F
                      license
                      -
                      quality
                      A Model Context Protocol (MCP) server that allows AI assistants like Claude to control real smart bulbs via UDP network communication, featuring voice commands, AI reasoning, and direct hardware control.
                      Last updated -
                      1

                    View all related MCP servers

                    MCP directory API

                    We provide all the information about MCP servers via our MCP API.

                    curl -X GET 'https://glama.ai/api/mcp/v1/servers/ThomasRohde/hue-mcp'

                    If you have feedback or need assistance with the MCP directory API, please join our Discord server