mcp-ha: Home Assistant 用の MCP サーバー（アドオンとして）

この Home Assistant アドオンは、MCP（Model Context Protocol）サーバーを公開します。実際には、Claude、Gemini、またはその他の MCP クライアントをインスタンスに接続して、家と会話します。

「どの照明が点けっ放しだった？」「昨夜、暖房の自動化が作動しなかったのはなぜ？」「今週のエネルギー使用量をプロットして。」

ドキュメント: devitek.github.io/mcp-ha（英語とフランス語）

対象範囲

合計 16 のツールがあり、LLM のコンテキストウィンドウを節約するように設計されています。コンパクトでページネーションされ、上限付きの応答と、アシスタントをより正確なクエリに導くメモが含まれます。

Related MCP server: hass-mcp

公式の HA MCP インテグレーションを使わない理由

それは存在し、動作しますが、Assist API を経由します。Assist に公開されたエンティティのみで、履歴、レジストリ、アドオン、オートメーション設定はありません。このアドオンは、直接かつ詳細なアクセスを提供します。両方共存できます。

インストール

要件: Home Assistant OS または Supervised（アドオンには Supervisor が必要です）。

1. このリポジトリをアドオンリポジトリに追加します:

   

   または手動で: 設定、アドオン、アドオンストア、三点リーダーメニュー、リポジトリ、そして https://github.com/Devitek/mcp-ha を貼り付けます。

2. 「MCP Home Assistant」をインストールして起動します。

3. アドオンの「設定」タブを開きます。初回起動時に API トークンが生成され、そこに保存されています（アドオンのログにも出力されます）。

クライアントの接続

Claude Code:

claude mcp add --transport http home-assistant \
  http://HA_IP:9583/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

Claude Desktop と Gemini CLI: ドキュメントサイトの クライアントガイド を参照してください。

セキュリティ（概要）

• デフォルトでは読み取り専用。 サービス呼び出しツールは、allow_write を有効にしない限りクライアントには存在しません。

• 書き込みを有効にした場合の多層防御: 危険なサービス（HA シャットダウン、shell_command など）の拒否リスト、エンティティのグロブ許可/拒否リスト、dry_run モード、ログ内のすべての試行の JSON 監査証跡。

• LAN のみ。 TLS も OAuth もありません。ポート 9583 をインターネットに公開しないでください。

完全な脅威モデルは SECURITY.md にあります。

ドキュメント

• ドキュメントサイト: インストール、設定、クライアント、ツールリファレンス、アーキテクチャ（英語とフランス語）

• アドオンドキュメント: HA インターフェースに表示されるページ

• コントリビューティングガイド: 開発環境、規約、リリース

• リポジトリのイシュー: プロジェクトのナレッジベース。すべての設計決定と落とし穴は、décision と écueil ラベル（フランス語）で追跡されています。

ライセンス

MIT