Hass MCP

🚀 Hass - MCP 説明ドキュメント

Hass - MCPは、Home Assistant統合用のModel Context Protocol (MCP)サーバーです。Claudeやその他の大規模言語モデル（LLMs）とのやり取りをサポートしています。

🚀 クイックスタート

Hass - MCPを使用することで、ClaudeなどのAIアシスタントが直接あなたのHome Assistantインスタンスとやり取りできるようになります。これにより、以下のような機能を実現できます。

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

✨ 主な機能

• エンティティ管理：状態の取得、デバイスの制御、エンティティの検索
• バージョン取得ツール：Home Assistantのバージョン情報を取得する
• エンティティ操作ツール：エンティティに対して操作（オープン、クローズ、切り替えなど）を実行する
• エンティティリストツール：すべてのエンティティのリストを取得し、ドメインでのフィルタリングと検索をサポートする
• 自動化リストツール：すべての自動化のリストを取得する
• サービス呼び出しツール：Home Assistantの任意のサービスを呼び出す
• Home Assistant再起動ツール：Home Assistantインスタンスを再起動する
• 状態履歴記録ツール：特定のエンティティの状態履歴を取得する
• エラーログ取得ツール：Home Assistantのエラーログを取得する

📦 インストール

テストの実行

uv run pytest tests/

📚 ドキュメント

ガイド付き会話のヒント

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 License