ホームアシスタントMCP

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

概要

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

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

Related MCP server: Home Assistant MCP Server

前提条件

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

インストール

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

cd home-assistant python -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate pip install -U pip pip install uv uv pip install -e .

構成

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

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

カーソルAIで設定

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

{ "mcpServers": { "home_assistant": { "command": "uv", "args": [ "--directory", "/path/to/your/home-assistant-mcp", "run", "main.py" ], "env": { "HOME_ASSISTANT_TOKEN": "your_home_assistant_token_here" }, "inheritEnv": true } } }

交換する：

/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 は、高度な照明制御機能をサポートするようになりました。

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

トラブルシューティング

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