voska/hass-mcp

解決的問題

它允許 AI 助手（例如 Claude）直接與 Home Assistant 實例互動。這使得使用者能以自然語言而非手動設定來控制智慧家居、查詢裝置狀態、排除自動化問題，並管理儀表板。

工作原理

它實作了 Model Context Protocol (MCP) 伺服器，作為 LLM 與 Home Assistant API 之間的橋樑。它提供一組工具，讓 LLM 可以呼叫來執行操作（例如關閉燈光）、取得資料（例如感測器歷史記錄或錯誤日誌），並透過 WebSocket 編輯 Lovelace 儀表板，同時支援 stdio 與可串流的 HTTP 傳輸方式。

適用對象

希望將家庭自動化與進階 AI 代理整合，以實現更輕鬆控制與引導式故障排除的智慧家居愛好者與 Home Assistant 使用者。

主要特色

• 完整裝置控制：查詢狀態、控制實體、呼叫任何 Home Assistant 服務。
• 儀表板編輯：讀取並即時編輯 Lovelace 儀表板，支援自動備份與預覽模式。
• 進階診斷功能：可存取 Home Assistant 錯誤日誌與實體狀態歷史/統計資料。
• 引導式對話：內建提示，用於建立自動化、除錯問題與優化流程。
• 高效使用 Token：使用輕量級 JSON 回應，最大限度減少 LLM 的 Token 消耗。
• 彈性部署：支援 Docker、uv/uvx 與 HTTP 傳輸，適用於網路化工具。