Home Assistant

MCP プロトコルを使用して Home Assistant スマートホーム デバイスを制御し、状態をクエリします。

前提条件

Home Assistant で MCP サーバーを有効にします:

• Home Assistant インスタンスにアクセスします。
• 設定 > デバイスとサービス に移動します。
• 右下隅の + 統合を追加 ボタンをクリックします。
• リストから Model Context Protocol を選択します。
• 画面上の指示に従ってセットアップを完了します。

設定

MCP サーバーが存在しないというメッセージが表示された場合は、ユーザーに以下のコマンドを実行して HASS_BASE_URL および HASS_ACCESS_TOKEN 環境変数を設定するよう案内してください:

npx -y mcporter config add home-assistant \
  --transport http \
  --url "${HASS_BASE_URL:-http://homeassistant.local:8123}/api/mcp" \
  --header "Authorization=Bearer \${HASS_ACCESS_TOKEN}"

使用方法

# 状態を取得
npx -y mcporter call home-assistant.GetLiveContext

# デバイスをオンにする
npx -y mcporter call home-assistant.HassTurnOn(name: "Bedroom Light")
npx -y mcporter call home-assistant.HassTurnOn(name: "Light", area: "Bedroom")

# デバイスをオフにする
npx -y mcporter call home-assistant.HassTurnOff(name: "Bedroom Light")
npx -y mcporter call home-assistant.HassTurnOff(area: "Bedroom", domain: ["light"])

# ライトを制御
# brightness: ライトの明るさ(パーセンテージ)。0 はオフ、100 は全光です。
# color: 色の名前
npx -y mcporter call home-assistant.HassLightSet(name: "Bedroom Light", brightness: 50)

# ファンを制御
# percentage: ファンの速度(パーセンテージ)。0 はオフ、100 は最高速度です。
npx -y mcporter call home-assistant.HassFanSetSpeed(name: "Fan", area: "Bedroom", percentage: 80)

以下のコマンドを実行して、特定の使用方法について詳しく学べます:

• npx -y mcporter list home-assistant --schema --all-parameters

mcporter について

• 互換性を向上させるため、コマンド実行時に mcporter の代わりに npx -y mcporter を使用してください。
• https://github.com/steipete/mcporter/raw/refs/heads/main/docs/call-syntax.md
• https://github.com/steipete/mcporter/raw/refs/heads/main/docs/cli-reference.md