非公式Home Assistant MCPサーバー

ha-mcpは、Model Context Protocol（MCP）に基づくスタンドアローンサーバーであり、AIアシスタントがHome Assistantスマートホームプラットフォームと深く対話できるようにします。自然言語を使用することで、デバイス制御、状態照会、サービスの実行、自動化管理などが可能です。このプロジェクトはGitHubで3400以上のスターと137のフォークを獲得しており、活発なコミュニティに支えられています。

インストール方法は多様で、macOS、Linux、Windows、Home Assistant OSに対応しています。macOSおよびWindowsユーザーは簡単なコマンドラインスクリプトで迅速にインストールし、Claude Desktopに接続できます。Linuxユーザーはコミュニティ版Claude Desktopまたは公式Claude Codeを選択可能です。Home Assistant OSユーザーは公式アドオンから直接インストールでき、リモートアクセスはNabu CasaまたはWebhookプロキシを介して行えます。特別なトンネルやポート転送は不要です。

ha-mcpは84のツールを提供し、検索・発見、デバイス制御、管理、監視、システム操作、セキュリティの各カテゴリに分類されます。具体的には、あいまいエンティティ検索、詳細設定検索、単一・一括デバイス制御、自動化・スクリプト管理、ダッシュボード編集、エリア・ラベル管理、履歴・統計、カメラスナップショット、自動化トレース、ZHAデバイス管理、バックアップ・復元、アップデート、アドオン操作などがあります。セキュリティ機能として、読み取り専用モード、ツールごとの有効/無効、ユーザー承認ポリシー、自動編集バックアップを備えています。

Home Assistant組み込みのMCPサーバーと比較すると、ha-mcpの利点は明らかです。組み込みサーバーはAssistに公開されたエンティティのみを制御できますが、ha-mcpはHome Assistant内のすべてのエンティティにアクセスでき、自動化、スクリプト、シーン、ダッシュボードの作成・編集、自動化のデバッグ、ヘルパー、エリア、ラベル、グループの管理、さらにバックアップ、アドオン、HACS、デバイスレジストリの管理まで可能です。つまり、組み込みサーバーは音声制御向けであり、ha-mcpはAIアシスタントによるスマートホームの構築・保守を目的としています。

さらに、ha-mcpはベータ版のカスタムコンポーネントha_mcp_toolsを提供し、ファイルシステムアクセスやYAML設定編集などの高度な機能を実現します。このコンポーネントはHACSまたは手動でインストールでき、必要な環境変数（HAMCP_ENABLE_FILESYSTEM_TOOLS=trueなど）を設定することで有効化されます。インストール後、configuration.yamlの安全な編集やファイルの読み書きが可能になります。その他のツールはこのコンポーネントなしで動作します。

全体として、ha-mcpはHome Assistantユーザーに強力なAI統合機能をもたらし、スマートホームの設定と管理をより直感的かつ効率的にします。初心者から上級者まで、自然言語によるAIアシスタントとの協調により、自動化体験を大幅に向上させることができます。