Home Assistant MCP

ホームアシスタントMCP

AI アシスタントを使用して Home Assistant デバイスを制御するためのモデル コンテキスト プロトコル (MCP) 統合。

概要

このMCPを使用すると、AIアシスタントがHome Assistantデバイスを制御できるようになります。以下のツールが提供されます。

1. Home Assistantインスタンス内のエンティティを検索する
2. デバイスを制御する（オン/オフにする）
3. 光の色と明るさを制御する

前提条件

• Python 3.11以上
• Home Assistant インスタンスが実行中であり、API 経由でアクセス可能
• ホームアシスタント長期アクセストークン

インストール

1. このリポジトリをクローンする
2. Python 環境をセットアップします。

構成

Home Assistantの長期アクセストークンを取得する

1. Home Assistantインスタンスに移動する
2. プロフィールに移動します（サイドバーのユーザー名をクリックします）
3. 「長期アクセストークン」までスクロールします。
4. 「MCP統合」のようなわかりやすい名前で新しいトークンを作成します
5. トークンをコピーします（一度だけ表示されます）

カーソルAIで設定

Cursor の MCP 構成に次の構成を追加します。

交換する：

• /path/to/your/home-assistantこのディレクトリへの実際のパスに置き換えます
• your_home_assistant_token_hereに Home Assistant 長期アクセストークンを入力します。

ホームアシスタントのURL設定

デフォルトでは、MCP はhttp://homeassistant.local:8123で Home Assistant に接続しようとします。

Home Assistant が別の URL にある場合は、 app/config.pyのHA_URL変数を変更できます。

使用法

設定が完了すると、Cursor AI を使用して Home Assistant デバイスを制御できるようになります。

• デバイスを検索:「リビングルームの照明を探す」
• 制御デバイス：「キッチンのライトをつけて」
• ライトの色を制御する: 「リビングルームのライトを赤に設定して」
• 明るさを調整する: 「ダイニングルームの照明を青、明るさ 50% に設定」

照明制御機能

MCP は、高度な照明制御機能をサポートするようになりました。

1. カラーコントロール: 互換性のあるライトのRGBカラーを設定します
   • RGB値（各コンポーネント0～255）を使用して色を指定します
   • 例: 赤の場合はset_device_color("light.living_room", 255, 0, 0)
2. 明るさコントロール：ライトの明るさを調整します
   • オプションの明るさパラメータ（0～255）
   • 色の変更と組み合わせることができます
   • 例: 中程度の明るさの青の場合set_device_color("light.dining_room", 0, 0, 255, brightness=128)

トラブルシューティング

• 認証エラーが発生した場合は、トークンが正しく、期限切れになっていないことを確認してください。
• 設定されたURLでHome Assistantインスタンスにアクセスできることを確認します
• 色の制御に関する問題について:
  • ライトエンティティがRGBカラーコントロールをサポートしていることを確認する
  • 色を変える前にライトが点灯していることを確認してください

将来の機能

動的エンティティエクスポージャー

現在の実装では、デバイスを制御するために 2 段階のプロセスが必要です。

1. 自然言語を使用してエンティティを検索する
2. 特定のentity_idを使用してエンティティを制御する

計画されている機能強化では、エンティティを制御デバイス ツールに公開するためのより動的な方法を作成し、AI が次のことを実行できるようにします。

• より自然なコマンドでデバイスを直接制御する（例：「キッチンのライトを消して」）
• 頻繁に使用するエンティティをキャッシュしてアクセスを高速化する
• 明るさ、温度、その他の属性の調整など、より複雑な操作をサポートします
• エンティティグループとシーンをより直感的に操作する

これにより、AI アシスタントを介して Home Assistant デバイスを制御する際の操作時間が大幅に短縮され、よりシームレスなユーザー エクスペリエンスが実現します。