Hass MCP

🚀 Hass-MCP 說明文檔

Hass-MCP 是一款專為 Home Assistant 集成打造的 Model Context Protocol (MCP) 服務器，它支持與 Claude 等大語言模型（LLMs）進行交互，能讓 AI 助手直接與 Home Assistant 實例通信，為智能家居管理帶來更多便利。

🚀 快速開始

Hass-MCP 可使 AI 助手（如 Claude）直接與您的 Home Assistant 實例交互，實現諸多實用功能，例如查詢設備和傳感器狀態、控制燈和開關等實體、獲取智能家居概要信息、排除自動化和實體問題、搜索特定實體以及創建常見任務的引導對話等。

✨ 主要特性

• 實體管理：可獲取實體狀態、控制設備以及搜索實體。
• 版本獲取工具：能獲取 Home Assistant 的版本信息。
• 實體操作工具：可對實體執行打開、關閉、切換等操作。
• 實體列表工具：獲取所有實體列表，支持按領域過濾和搜索。
• 自動化列表工具：獲取所有自動化的列表。
• 服務調用工具：調用 Home Assistant 的任意服務。
• 重啟 Home Assistant 工具：重啟 Home Assistant 實例。
• 狀態歷史記錄工具：獲取某個實體的狀態歷史記錄。
• 錯誤日誌獲取工具：獲取 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}：搜索與查詢匹配的實體，並自定義結果限制。

💻 使用示例

基礎用法

uv run pytest tests/

📄 許可證

MIT License