remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Allows AI assistants to control Home Assistant devices, providing tools to search for entities in a Home Assistant instance and control devices (turn them on/off) through the Home Assistant API.

ホームアシスタントMCP

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

概要

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

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

前提条件

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カラーコントロールをサポートしていることを確認する
- 色を変える前にライトが点灯していることを確認してください

将来の機能

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

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

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

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

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

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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

モデルコンテキストプロトコル (MCP) 統合により、AI アシスタントはエンティティを検索し、自然言語コマンドを使用してデバイスを制御することで、Home Assistant デバイスを制御できるようになります。

Related Resources

Reddit Discussion about this server

Home Assistant MCP