ホームアシスタントMCPサーバー
Home Assistantと統合し、LLM がスマート ホームを制御およびクエリできるようにするModel Context Protocol (MCP)サーバー。
特徴
自然言語でHome Assistantエンティティをクエリおよび制御する
MCP 互換クライアント（Claude Desktop など）で動作します
状態管理、サービス呼び出し、履歴などのツールを提供します
Home Assistantの長期アクセストークンを使用した安全な認証
複数のトランスポート オプション (ローカル プロセスの場合は stdio、リモート クライアントの場合は SSE)
Home Assistant が利用できない場合のテストとデモンストレーション用の模擬データを備えたデモ モード
Related MCP server: Home Assistant MCP Server
インストール
構成
次の変数を使用して、現在のディレクトリに.envファイルを作成します。
環境変数
変数 | 必須 | デフォルト | 説明 |
| はい | - | Home Assistant インスタンスへの URL (例: http://homeassistant.local:8123 ) |
| はい | - | Home Assistant で認証するための長期アクセス トークン |
| いいえ | 3000 | HTTP/SSEトランスポートを使用する場合のHTTPサーバーのポート番号 |
| いいえ | 間違い | 「true」に設定すると、Home Assistant接続なしでテストするための模擬データモードが有効になります |
長期間有効なアクセス トークンを取得するには:
Home Assistantインスタンスにログインする
プロフィール（左下）をクリックします
「長期アクセストークン」までスクロールします。
わかりやすい名前で新しいトークンを作成する
トークンの値をコピーします（再度表示されません）
使用法
スタンドアロンサーバーとして実行
Claude Desktopとの統合
Claude Desktop で使用するには:
Claude Desktop の設定ファイルを編集します。
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
サーバー構成を追加します。
Home Assistant を実行している場合は、 --mockフラグを削除し、 HASS_MOCK falseに設定するだけです。
Claudeデスクトップを再起動します
利用可能なツール
サーバーは、Home Assistant と対話するためのいくつかのツールを公開します。
states- エンティティの状態を照会するlights- ライトの一覧light- ライトを制御するservice- ホームアシスタントサービスに電話するhistory- 履歴エンティティデータを取得するservices- 利用可能なサービスを一覧表示するconfig- Home Assistantの設定を取得するdomains- 利用可能なドメインの一覧error_log- Home Assistant のエラーログを取得するdevices- Home Assistantですべてのデバイスを取得する
詳細な使用例については、 docs/hass-mcp.md を参照してください。
安全
このサーバーには、フルアクセス権限を持つHome Assistantアクセストークンが必要です。以下のセキュリティ推奨事項にご留意ください。
信頼できるネットワーク上でのみサーバーを実行する
サーバーをリモートで公開する場合はHTTPSを使用する
.envファイルを安全に保ち、ソース管理にコミットしないでください。可能な場合は、権限が制限されたトークンの使用を検討してください
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。