voska/hass-mcp

解決する課題

AIアシスタント（例：Claude）がHome Assistantインスタンスに直接アクセスできるようにします。これにより、ユーザーは手動の設定ではなく自然言語を使ってスマートホームを制御し、デバイスの状態を照会し、自動化のトラブルシューティングを行い、ダッシュボードを管理できます。

動作方法

Model Context Protocol (MCP) サーバーを実装し、LLMとHome Assistant APIの間のブリッジとして機能します。LLMが呼び出すことができるツール群を提供し、ライトの電源オフなどの操作、センサーの履歴やエラーログなどのデータ取得、WebSocket経由でのLovelaceダッシュボードの読み取りとリアルタイム編集（自動バックアップとドライランプレビュー対応）が可能になります。また、stdioおよびストリーミングHTTPトランスポートの両方をサポートしています。

対象ユーザー

スマートホーム愛好家やHome Assistantユーザーで、高度なAIエージェントと統合して、より簡単な制御とガイド付きトラブルシューティングを希望する方。

主な特徴

• 完全なデバイス制御：状態の照会、エンティティの制御、任意のHome Assistantサービスの呼び出し。
• ダッシュボード編集：Lovelaceダッシュボードの読み取りとリアルタイム編集、自動バックアップ、ドライランプレビュー対応。
• 高度な診断機能：Home Assistantのエラーログやエンティティの状態履歴・統計情報へのアクセス。
• ガイド付き会話：自動化の作成、問題のデバッグ、ルーチンの最適化のための組み込みプロンプト。
• トークン効率的：LLMのトークン消費を最小限に抑えるための軽量JSONレスポンスを使用。
• 柔軟なデプロイ：Docker、uv/uvx、HTTPトランスポートによるネットワークベースのツールをサポート。