Huemcp

🚀 フィリップス・ヒューMCPサーバーバンドル

フィリップス・ヒューのスマートライトを制御するためのMCPサーバーです。

✨ 主な機能

• mDNSを介した自動ブリッジ検出
• APIキーの設定と構成
• ライトの制御（オン/オフ、明るさ、色）
• ゾーン と 部屋 の管理
• グループ化されたライト のサポート

🚀 クイックスタート

Claude Desktopの場合

1. リリース からMCPBバンドルをダウンロードしてインストールします。
2. 設定（いずれかを選択）：
   • オプションA（推奨）：設定をスキップして組み込みツールを使用します。
     • discover_bridge ツールを使用してHueブリッジを見つけます。
     • Hueブリッジの物理ボタンを押します。
     • complete_bridge_setup ツールを使用してAPIキーを作成します。
   • オプションB：インストール中に設定ウィンドウにブリッジのIPアドレスとAPIキーを入力します。

その他のMCPクライアント（例：Cursor）の場合

1. リポジトリをクローンして依存関係をインストールします：

git clone https://github.com/yourusername/HUEMCP.git
cd HUEMCP
yarn install

2. 設定（いずれかを選択）： オプションA：対話型設定（推奨）

yarn setup

対話型のプロンプトに従ってブリッジを設定します。 オプションB：ENV変数を使用した手動設定

export HUE_BRIDGE_IP="your-bridge-ip"
export HUE_API_KEY="your-api-key"

3. サーバーを起動します：

yarn start

ブリッジのIPアドレスとAPIキーが必要ですか？ mDNSとcurlを使用した手順ごとの説明については、手動設定ガイド を参照してください。

🔧 技術詳細

現在、このMCPサーバーはPhilips Hue API v1に直接HTTP呼び出しを行っています。

将来の計画

node - hue - api ライブラリへの移行が計画されており、以下の機能を提供します。

• Philips Hue API v2のTypeScript実装
• 型定義付きの完全なAPIカバレッジ
• シーン管理とスケジューリング
• 色のストリーミング用のエンターテイメントAPI
• 向上したパフォーマンスと機能

📚 ドキュメント

完全なドキュメントは docs/ にあります。

📄 ライセンス

MIT