Openhue

🚀 OpenHue MCP サーバー

OpenHue CLI を通じて、フィリップス Hue 照明を制御する MCP サーバーです。Claude やその他の LLM インターフェースとの対話もサポートしています。

🚀 クイックスタート

このサーバーを使用する前に、いくつかの前提条件を満たす必要があります。

🔧 前提条件

• Node.js (v16 以上)
• Docker
• Claude デスクトップ版（テスト用、オプション）

🛠️ ブリッジ設定

サーバーを使用する前に、OpenHue CLI を使って Hue ブリッジを設定する必要があります。

1. インストールコマンドを実行します。

# Linux/macOS の場合：
docker run -v "${HOME}/.openhue:/.openhue" --rm --name=openhue -it openhue/cli setup

# Windows（PowerShell）の場合：
docker run -v "${env:USERPROFILE}\.openhue:/.openhue" --rm --name=openhue -it openhue/cli setup

2. 画面の指示に従います。

   • CLI が Hue ブリッジを検索します。
   • 指示が出たら、Hue ブリッジのリンクボタンを押します。
   • 設定完了の確認を待ちます。

3. 照明をリストアップすることで設定を検証します。

# Linux/macOS の場合：
docker run -v "${HOME}/.openhue:/.openhue" --rm --name=openhue -it openhue/cli get lights

# Windows（PowerShell）の場合：
docker run -v "${env:USERPROFILE}\.openhue:/.openhue" --rm --name=openhue -it openhue/cli get lights

照明がリストされれば、設定は完了です。MCP サーバーの使用を開始できます。

📦 インストール

1. リポジトリをクローンします。

git clone <your-repo-url>
cd claude-mcp-openhue

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

npm install

3. プロジェクトをビルドします。

npm run build

4. サーバーを起動します。

npm start

✨ 主な機能

このサーバーは、MCP を通じて以下の機能を提供します。

💡 照明制御

• すべての照明または特定の照明の情報をリストアップする
• 照明のオン/オフを切り替える
• 明るさと色を調整する

🏠 部屋制御

• 部屋の情報を取得する
• 部屋内のすべての照明の状態を取得する
• 部屋内の照明を制御する

🎨 シーン管理

• シーンの作成、削除、更新を行う
• すべてのシーンをリストアップする
• 指定したシーンを適用する

🔧 開発

📁 プロジェクト構造

.
├── src/
│   └── index.ts    # メインサーバーの実装ファイル
├── build/          # コンパイル後の JavaScript フォルダ
├── package.json
├── tsconfig.json
└── README.md

🏗️ ビルド

npm run build

▶️ 実行

npm start

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

🚫 サーバーに接続できない場合

1. Docker が実行中かどうかを確認します。
2. OpenHue の設定が存在するかを検証します。
3. Claude デスクトップ版のログを確認します。
4. OpenHue CLI を直接実行してみます。

❌ コマンドが失敗する場合

1. OpenHue CLI の権限を確認します。
2. 照明/部屋/シーンの名前が正しいことを確認します。
3. Docker コンテナのログを確認します。
4. Hue ブリッジの接続性を検証します。

📄 ライセンス

MIT License

🤝 貢献の方法

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更をコミットします。
4. ブランチにプッシュします。
5. 新しい Pull Request を作成します。