Hue BLE MCP

hue-ble-mcp

Claude から Bluetooth LE 経由で Philips Hue ライトを操作できる MCP サーバーです。Hue Bridge もインターネット接続も必要ありません。

Claude に次のように頼むだけです：

• 「ライトを消して」
• 「ライトを暖かみのある読書モードにして」
• 「深い青色にして」
• 「明るさを20%にして」

ツール

ツール	説明
scan_hue_lights	近くにある Hue BLE ライトを検出し、アドレスを取得します
turn_on	ライトを点灯します
turn_off	ライトを消灯します
set_brightness	明るさを1～100%に設定します
set_color_temperature	白色の色温度を設定します（暖色の2000K～寒色の6500K）
set_color	RGB カラーを設定します
get_light_state	現在の電源状態、明るさ、カラーモードを読み取ります
set_scene	プリセットを適用します：relax、energize、concentrate、reading、nightlight、bright

要件

• macOS（bleak 経由で CoreBluetooth を使用します）
• Python 3.10+
• Bluetooth 対応の Philips Hue ライト（2019年以降に製造されたライトのほとんどが対応しています）
• Claude Desktop

インストール

オプション1：pip（推奨）

pip install hue-ble-mcp

次に、~/Library/Application Support/Claude/claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "hue-ble": {
      "command": "hue-ble-mcp",
      "env": {
        "HUE_LIGHT_ADDRESS": ""
      }
    }
  }
}

オプション2：クローンして実行

git clone https://github.com/jonnyblankinship/hue-ble-mcp.git
cd hue-ble-mcp
python3 -m venv venv
./venv/bin/pip install -r requirements.txt

次に、claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "hue-ble": {
      "command": "/absolute/path/to/hue-ble-mcp/venv/bin/python",
      "args": ["/absolute/path/to/hue-ble-mcp/server.py"],
      "env": {
        "HUE_LIGHT_ADDRESS": ""
      }
    }
  }
}

初回セットアップ

1. ライトをペアリングする

Hue BLE ライトは、初めて接続するときにペアリングモードにする必要があります。最も簡単な方法は、Hue アプリからライトをリセットすることです（Settings → Light setup → ライトを選択 → Delete）。これにより、工場出荷時のペアリングモードに戻ります。

最初の接続に成功すると、macOS がペアリング情報を記憶するため、再度この操作を行う必要はありません。

2. ライトのアドレスを確認する

Claude Desktop を再起動して、次のように尋ねます：

「Hue ライトをスキャンして」

Claude は次のような情報を返します：

[
  {
    "name": "Signe gradient floor",
    "address": "77577FFA-2F08-CAFD-5F3C-5C1824D8C362"
  }
]

macOS では、アドレスは MAC アドレスではなく UUID です。これは正常な動作です。CoreBluetooth が独自の識別子を割り当てます。

3. デフォルトのアドレスを設定する

アドレスを設定ファイルの HUE_LIGHT_ADDRESS に貼り付け、Claude Desktop を再起動します。以降は、コマンドごとにアドレスを指定する必要はありません。

"env": {
  "HUE_LIGHT_ADDRESS": "77577FFA-2F08-CAFD-5F3C-5C1824D8C362"
}

仕組み

Philips Hue ライトは、独自仕様ながら詳しいドキュメントが公開されている GATT プロファイルを使用して、Bluetooth LE 経由で通信します。このサーバーは bleak を使って GATT 特性に直接書き込むため、Hue Bridge や Hue クラウドは一切必要ありません。

使用する主な特性：

UUID	機能
932c32bd-0002-...	電源（オン／オフ）
932c32bd-0003-...	明るさ
932c32bd-0004-...	色温度（ミレッド）
932c32bd-0005-...	XY カラー（CIE 1931）

RGB カラーは、ライトに送信する前にワイド RGB D65 色域マトリックスを使用して CIE 1931 XY 色空間に変換されます。

制限事項

• macOS のみ — Linux でも動作するはずですが、テストされていません。Windows はサポートされていません。
• Bluetooth の通信範囲 — ライトから約10m以内にいる必要があります。
• ライトごとに1つのアダプター — ライトは初回のペアリングに使用した Bluetooth アダプターとペアリングされます。別の Mac から接続するには、再ペアリングが必要です。
• 複数のライト — 対応しています。各ツールを対象のアドレスとともに呼び出してください。利便性のため、メインのライトを HUE_LIGHT_ADDRESS に設定します。

ライセンス

MIT