Home Assistant MCPサーバー

「Home Assistant」MCPサーバーは何をする？

Home Assistant MCPサーバー（hass-mcp）は、モデルコンテキストプロトコル（MCP）サーバーであり、ClaudeなどのAIアシスタントや他の大規模言語モデル（LLM）とHome Assistantエコシステムをつなぎます。Home Assistantのデータや機能をMCP標準で公開することで、AIエージェントがスマートホームデバイスや自動化のクエリ・制御・対話が可能に。hass-mcpで実現できる典型的なタスクには、デバイスやセンサー状態の取得、ライトやスイッチの切り替え、家全体の状態要約、自動化のトラブルシューティング、特定エンティティの検索、よくあるスマートホーム操作のガイド付き会話などがあります。この連携により、スマートホーム管理が会話型AI・自動化・LLMエージェントを通じて開発者・ユーザー双方により身近になります。

プロンプト一覧

• リポジトリにドキュメント化されたプロンプトテンプレートはありませんでした。

リソース一覧

• リポジトリに明示的なMCPリソースの記載はありませんでした。

ツール一覧

• デバイスやセンサー状態のクエリ：LLMがHome Assistantエンティティの現在の状態を取得できます。
• ライト・スイッチ・他エンティティの制御：対応スマートホーム機器の直接制御（オン/オフ、明るさ調整など）が可能です。
• スマートホーム全体の要約取得：現在の家の状態を高レベルで集約・要約して提供します。
• 自動化やエンティティのトラブルシュート：自動化やデバイスの問題解決のための診断情報や手順を提供します。
• 特定エンティティの検索：Home Assistant内のデバイスやセンサーを名前や種類で素早く探せます。
• よくあるタスクのガイド付き会話作成：頻繁なスマートホーム操作を構造化した対話で案内します。

このMCPサーバーのユースケース

• デバイス状態のクエリ：開発者やユーザーは「キッチンの窓は開いてる？」などの状態を会話やプログラムで問い合わせ、監視や自動化ロジックに活用できます。
• スマートホーム制御：音声アシスタントやチャットボット経由でライトのオン/オフ、サーモスタット調整、家電制御などが可能となり、アクセシビリティと自動化を強化。
• ホーム要約レポート：LLMが日次や随時で「今晩の家の状態は？」などの要約レポートを生成し、ダッシュボード統合やユーザー利便性向上に役立ちます。
• 自動化トラブルシュート：開発者はMCPサーバーを使い、自動化設定ミスや障害の特定・デバッグを効率化できます。
• エンティティ検索＆ガイド付きタスクフロー：デバイスの素早い検索や「朝のルーチン設定」など複数ステップの作業案内で管理が簡単に。

セットアップ方法

Windsurf

1. システムにPythonとDockerがインストールされていることを確認します。
2. hass-mcpリポジトリをクローンし、.envファイル（.env.exampleを参照）でHome Assistant接続を設定します。
3. Windsurfの設定画面でMCPサーバーセクションを開きます。
4. 以下のようなJSON設定でhass-mcpサーバーを追加します：

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "docker",
         "args": ["run", "--env-file=.env", "-p", "8080:8080", "voska/hass-mcp:latest"]
       }
     }
   }
   

5. 設定を保存してWindsurfを再起動し、MCPリストにサーバーが表示されることを確認してください。

Claude

1. hass-mcpサーバーをローカルまたはClaudeからアクセス可能なサーバーにデプロイします。
2. Home Assistant APIキーを環境変数で安全に管理します。
3. Claudeの設定ファイルにMCPサーバーエントリを追加します：

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "python",
         "args": ["-m", "app.main"]
       }
     }
   }
   

4. Claudeを再起動しMCPサーバー利用可否を確認します。
5. センシティブなデータは必ず環境変数で保護してください（下記参照）。

Cursor

1. hass-mcpをデプロイし、CursorとMCPサーバー間のネットワーク接続を確保します。
2. Cursor設定でMCPサーバーを使用するように指定します：

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "python",
         "args": ["-m", "app.main"]
       }
     }
   }
   

3. 設定を保存し、Cursorを再起動します。
4. 必要に応じてAPIキーのための環境変数を設定してください。

Cline

1. 依存関係をインストール後、hass-mcpサーバーを起動します（詳細はリポジトリ参照）。
2. ClineでMCP設定ファイルを開きます。
3. hass-mcpサーバーを追加します：

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "python",
         "args": ["-m", "app.main"]
       }
     }
   }
   

4. Clineを再起動し、新しいMCPサーバーを有効化します。

APIキーの保護（全プラットフォーム共通）：

設定内で環境変数を利用し、機密情報を守りましょう：

{
  "mcpServers": {
    "hass-mcp": {
      "env": {
        "HASS_TOKEN": "${HASS_TOKEN}"
      },
      "inputs": {
        "hass_url": "http://your-homeassistant.local:8123"
      }
    }
  }
}

FlowHuntフローでのMCPサーバー利用方法

FlowHuntにMCPサーバーを組み込むには、フローにMCPコンポーネントを追加し、AIエージェントと接続します：

MCPコンポーネントをクリックして設定パネルを開き、システムMCP設定欄に以下のようなJSON形式でMCPサーバー情報を入力します：

{
  "hass-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

設定すればAIエージェントがこのMCPの全機能にアクセスできるようになります。実際のMCPサーバー名やURLはご利用環境に合わせて変更してください。

概要

公開ドキュメントとリポジトリ内容から、hass-mcpはMCP経由のHome Assistant連携の堅実な基盤を提供し、明確なツールサポートと現実的なセットアップ／セキュリティ手法が用意されています。一方で、プロンプトテンプレートやリソース定義、高度なサンプリング・ルーツ機能の記載は見当たりません。全体としてこのMCPサーバーを6/10点と評価します：機能的かつ開発者フレンドリーですが、拡張性や高度なMCP機能のドキュメントが不足しています。

MCPスコア