Ha Mcp For Xiaozhi について
ha-mcp-for-xiaozhi は、Home Assistant を MCP サーバーとして WebSocket 経由で小智 AI のサーバーに直接接続する統合プラグインです。小智の音声操作でスマートホームを制御したい Home Assistant の利用者向けです。
主な機能
- 01Home Assistant を MCP サーバーとして直接接続
- 02複数の API グループをまとめて小智へ中継
- 03複数のエンティティの設定に対応
- 04HACS からのインストールと UI での設定
活用シーン
- 01小智 AI の音声で Home Assistant のデバイスを操作
- 02Home Assistant に接続済みの他の MCP サーバーを小智へ中継
- 03スマートホーム向けコマンドの処理状況の確認とデバッグ
MCP 対応
Home Assistant 自体が WebSocket 経由で小智 AI のエンドポイントに接続する MCP サーバーとして動作し、設定済みの他の MCP サーバーも中継できます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
ha-mcp-for-xiaozhi
小智AI公式サーバーに直接接続する、Homeassistant用MCPサーバーです。
インテグレーションの機能
1.HomeAssistant自体をMCPサーバーとして、WebSocketプロトコルで虾哥サーバーに直接接続します。中継は不要です。
2.1つのエンティティで複数のAPIグループ(HomeAssistant標準の制御API、ユーザーが設定したMCPServer)を同時に選択し、まとめて小智にプロキシできます。
3.複数のエンティティを同時に設定できます
機能デモ(愛情で支えるのは大変です。コインがあれば投げ銭を、なければ「いいね」を、弾幕をいくつか流していただくだけでも大歓迎です)
HomeAssistant、LLM、MCP、小智の応用チュートリアル
インストール方法:
Home AssistantにHACSがインストールされていることを確認してください。
1.HACSを開き、xiaozhiまたはha-mcp-for-xiaozhiを検索します
2.インテグレーションをダウンロードします
3.Home Assistantを再起動します。
設定方法:
[設定 > デバイスとサービス > インテグレーションを追加] >「Mcp」を検索 > MCP Server for Xiaozhiを見つけます
次へ > 小智MCP接続先アドレスを入力し、必要なMCPを選択 > 送信します。
llm_hass_apiのチェックボックスにあるAssistは、ha標準のfunctionです。それ以外の選択肢は、HomeAssistantに接続した他のMCPサーバーです(ここで小智に直接プロキシできます)。
設定完了!!!1分ほど待ってから小智の接続先ページで更新をクリックし、ステータスを確認してください。
デバッグ方法
1.公開されるツールは、Homeassistant音声アシスタントに公開したエンティティの種類によって決まります。
設定 -> 音声アシスタント -> 公開
2.できるだけ最新バージョンのhomeassistantを使用してください。5月版と3月版で提供されるツールには、明らかな違いがあります。
3.デバッグ時に期待した結果が得られない場合は、まず小智のチャット履歴を確認し、その指示を小智がどのように処理したか、Homeassistantのツールを呼び出したかを確認してください。現在確認されている大きな問題として、照明制御や音楽制御が、内蔵の画面制御・音楽制御のロジックと競合します。来月、虾哥サーバーで内蔵ツールの選択がサポートされれば解決できる見込みです。
4.処理が正しくha標準のfunctionを呼び出している場合は、このインテグレーションのデバッグログを有効にして、実際の実行状況を確認できます。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。