ハス-MCP

Home Assistant を Claude やその他の LLM と統合するための Model Context Protocol (MCP) サーバー。

概要

Hass-MCP を使用すると、Claude などの AI アシスタントが Home Assistant インスタンスと直接対話できるようになり、次のことが可能になります。

• デバイスとセンサーの状態を照会する
• 照明、スイッチ、その他のエンティティを制御する
• スマートホームの概要を取得する
• 自動化とエンティティのトラブルシューティング
• 特定のエンティティを検索する
• 一般的なタスクのためのガイド付き会話を作成する

スクリーンショット

特徴

• エンティティ管理: 状態を取得し、デバイスを制御し、エンティティを検索します
• ドメインサマリー: エンティティタイプに関する高レベルの情報を取得します
• 自動化サポート: 自動化の一覧表示と制御
• ガイド付き会話:自動化の作成などの一般的なタスクにプロンプトを使用します
• スマート検索: 名前、タイプ、または状態でエンティティを検索します
• トークン効率: トークンの使用を最小限に抑えるためのJSONレスポンスの簡素化

インストール

前提条件

• 長期アクセストークンを持つホームアシスタントインスタンス
• 次のいずれか:
  • Docker（推奨）
  • Python 3.13+ およびuv

Claude Desktop の設定

Docker のインストール (推奨)

1. Docker イメージをプルします。
   docker pull voska/hass-mcp:latest
2. Claude Desktop に MCP サーバーを追加します。a. Claude Desktop を開いて [設定] に移動します。 b. [開発者] > [設定の編集] に移動します。 c. claude_desktop_config.jsonファイルに次の設定を追加します。
   { "mcpServers": { "hass-mcp": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "HA_URL", "-e", "HA_TOKEN", "voska/hass-mcp" ], "env": { "HA_URL": "http://homeassistant.local:8123", "HA_TOKEN": "YOUR_LONG_LIVED_TOKEN" } } } }
   d. YOUR_LONG_LIVED_TOKENを実際の Home Assistant 長期アクセス トークンに置き換えます。e. HA_URLを更新します。
   • 同じマシンで Home Assistant を実行している場合: http://host.docker.internal:8123 (Mac/Windows 上の Docker Desktop) を使用します。
   • Home Assistantを別のマシンで実行している場合: 実際のIPまたはホスト名を使用します

   f. ファイルを保存し、Claude Desktopを再起動します。

3. 「Hass-MCP」ツールがClaudeデスクトップのツールメニューに表示されるはずです。

注：同じマシン上のDockerでHome Assistantを実行している場合は、コンテナがHome Assistantにアクセスできるように、Docker引数に--network hostを追加する必要があるかもしれません。または、 host.docker.internalの代わりに、マシンのIPアドレスを使用してください。

その他のMCPクライアント

カーソル

1. カーソル設定 > MCP > 新しいMCPサーバーの追加に移動します
2. フォームに記入してください:
   • 名前: Hass-MCP
   • タイプ: command
   • 指示：
     docker run -i --rm -e HA_URL=http://homeassistant.local:8123 -e HA_TOKEN=YOUR_LONG_LIVED_TOKEN voska/hass-mcp
   • YOUR_LONG_LIVED_TOKENを実際のHome Assistantトークンに置き換えます。
   • HA_URLをHome Assistantインスタンスのアドレスと一致するように更新します
3. 「追加」をクリックして保存します

クロード・コード（CLI）

Claude Code CLI で使用するには、 mcp addコマンドを使用して MCP サーバーを直接追加できます。

Docker の使用 (推奨):

YOUR_LONG_LIVED_TOKENを実際の Home Assistant トークンに置き換え、HA_URL を Home Assistant インスタンス アドレスと一致するように更新します。

使用例

Hass-MCP をセットアップしたら、Claude で使用できるプロンプトの例をいくつか示します。

• 「リビングルームの照明の現在の状態はどうですか？」
• 「キッチンの電気を全部消してください」
• 「温度データを含むすべてのセンサーを一覧表示する」
• 「私の気候エンティティの概要を教えてください」
• 「日没時に照明を点灯する自動化を作成する」
• 「寝室のモーションセンサーの自動化が機能しない原因のトラブルシューティングを手伝ってください」
• 「リビングルームに関連するエンティティを検索する」

利用可能なツール

Hass-MCP は、Home Assistant と対話するためのいくつかのツールを提供します。

• get_version : Home Assistantのバージョンを取得する
• get_entity : オプションのフィールドフィルタリングを使用して特定のエンティティの状態を取得します。
• entity_action : エンティティに対してアクションを実行する（オン、オフ、切り替え）
• list_entities : オプションのドメインフィルタリングと検索を使用してエンティティのリストを取得します。
• search_entities_tool : クエリに一致するエンティティを検索する
• domain_summary_tool : ドメインのエンティティの概要を取得する
• list_automations : すべての自動化のリストを取得します
• call_service_tool : Home Assistant サービスを呼び出す
• restart_ha : ホームアシスタントを再起動する
• get_history : エンティティの状態履歴を取得する
• get_error_log : Home Assistant のエラーログを取得する

ガイド付き会話のプロンプト

Hass-MCP には、ガイド付き会話のためのいくつかのプロンプトが含まれています。

• create_automation : トリガータイプに基づいてHome Assistantの自動化を作成するためのガイド
• debug_automation : 動作しない自動化のトラブルシューティングのヘルプ
• troubleshoot_entity : エンティティの問題を診断する
• routine_optimizer : 使用パターンを分析し、実際の動作に基づいて最適化されたルーチンを提案します。
• automation_health_check : すべての自動化を確認し、競合、冗長性、改善の機会を見つけます
• entity_naming_consistency : エンティティ名を監査し、標準化の改善を提案する
• dashboard_layout_generator : ユーザーの好みや使用パターンに基づいて最適化されたダッシュボードを作成します

利用可能なリソース

Hass-MCP は次のリソース エンドポイントを提供します。

• hass://entities/{entity_id} : 特定のエンティティの状態を取得する
• hass://entities/{entity_id}/detailed : すべての属性を持つエンティティの詳細情報を取得します。
• hass://entities : ドメイン別にグループ化されたすべての Home Assistant エンティティを一覧表示します。
• hass://entities/domain/{domain} : 特定のドメインのエンティティのリストを取得します
• hass://search/{query}/{limit} : カスタム結果制限でクエリに一致するエンティティを検索する

発達

テストの実行

ライセンス

MITライセンス