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 ブリッジに直接接続します
クイックスタート
次に、Claude で次のように始めます。「Philips Hue のライトを操作したいのですが、利用できるライトを教えてもらえますか?」
設定
前提条件
- Python 3.9以上
- ローカルネットワーク上のPhilips Hueブリッジ
- Philips Hue ライトをブリッジとペアリング
インストール
- このリポジトリをクローンするか、
hue_server.py
ファイルをダウンロードしてください。 - 必要な依存関係をインストールします。
初実行
- サーバーを実行します。
- プロンプトが表示されたら、Hueブリッジのリンクボタンを押して接続を承認します。
- 接続の詳細は、将来使用するために
~/.hue-mcp/config.json
に保存されます。
クロードと一緒に使う
オプション1: Claude Desktopにインストールする
Claude Desktop がインストールされている場合:
オプション2: MCP Inspectorでテストする
開発とテストの場合:
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 | スケジュールオプションについて学ぶ |
例
単一ライトの制御
グループでの作業
シーンの作成
詳細オプション
カスタム設定でサーバーを実行します。
トラブルシューティング
- ブリッジが見つかりません: 自動検出が機能しない場合は、次の 2 つのオプションがあります。
- スクリプト内の
BRIDGE_IP
変数をブリッジのIPアドレスで手動で編集します。 - 手動で設定ファイルを作成します。「192.168.1.x」を実際のHueブリッジのIPアドレスに置き換えます。Copy
- スクリプト内の
- 接続の問題:
~/.hue-mcp/config.json
を削除し、サーバーを再起動して再認証してください - ライト制御が機能しない:
refresh_lights
ツールを使用してライト情報キャッシュを更新します - グループまたはシーンが表示されない: ブリッジとサーバーを再起動してすべてのデータを同期してください
仕組み
このサーバーは、 phue
Pythonライブラリを使用してPhilips Hueブリッジに接続し、モデルコンテキストプロトコルを通じて機能を公開します。ClaudeのようなAIが接続すると、以下のようになります。
- サーバーは保存された資格情報を使用してブリッジを認証します
- 照明設定を説明するリソースを提供します
- クロードが照明を制御するために使用できるツールを公開します
- クロードがライトの操作方法を理解するのに役立つプロンプトを提供します
セキュリティとプライバシーのため、Hue システムとのすべての通信はネットワーク内でローカルに行われます。
貢献
貢献大歓迎!お気軽にどうぞ:
- 問題追跡システムでバグを報告したり機能を提案したりしてください
- 改善点を記載したプルリクエストを送信する
- スマートホームのセットアップでこれをどのように使用しているかの例を共有してください
ライセンス
このプロジェクトは MIT ライセンスの下で利用可能です。
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
Claude のような AI アシスタントが自然言語コマンドを通じて Philips Hue スマート照明システムを制御できるようにするモデル コンテキスト プロトコル インターフェイス。
Related MCP Servers
- AsecurityAlicenseAqualityAn 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 -40376TypeScriptMIT License
- -securityAlicense-qualityA 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 -PythonMIT License
- -securityAlicense-qualityA 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 -10PythonMIT License
- -securityAlicense-qualityA 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 -15PythonMIT License