hass-mcp

Home Assistantを制御およびクエリするためのオープンソースのMCPサーバー。

• トランスポート: stdio

• 認証: Home Assistantの長期アクセストークン

• API: Home Assistant REST API

機能

提供されるツール:

• ha_get_state — エンティティの状態を取得

• ha_list_states — 全状態をリスト表示（データ量が大きくなる可能性があります）

• ha_call_service — 任意のサービスを呼び出し

インストール

pnpm install
pnpm build

実行

export HASS_URL="http://homeassistant.local:8123"
export HASS_TOKEN="<your long-lived access token>"

pnpm start

MCPクライアントでの設定

例（概念）:

{
  "mcpServers": {
    "homeassistant": {
      "command": "npx",
      "args": ["-y", "hass-mcp"],
      "env": {
        "HASS_URL": "http://homeassistant.local:8123",
        "HASS_TOKEN": "..."
      }
    }
  }
}

セキュリティ

• トークンは機密情報として扱ってください。

• このサーバーはHome Assistantと同じLAN上で実行することを推奨します。

• Home AssistantがCloudflare Accessの背後にある場合は、このMCPサーバーをLAN側で実行してください。

ライセンス

MIT