ha-mcp: 這是什麼、解決了什麼問題以及為什麼它正受到關注

解決了什麼問題

這個專案提供了一種讓 AI 助手透過 Model Context Protocol (MCP) 與 Home Assistant 互動的方式。雖然 Home Assistant 已經內建了用於基本裝置控制的 MCP 伺服器，但此伺服器允許 AI 代理（AI agents）不僅能控制裝置，還能配置、建置與除錯整個智慧家庭設定，包括自動化、腳本（scripts）與儀表板（dashboards）。

如何運作

此伺服器充當 AI 客戶端（例如 Claude Desktop 或 ChatGPT）與 Home Assistant 之間的橋樑。它提供了超過 85 種工具，讓 AI 可以用來查詢狀態、執行服務並修改系統配置。對於編輯 YAML 檔案或存取檔案系統等進階任務，它利用了安裝在 Home Assistant 內部的配套自定義組件 (ha_mcp_tools)。

對象是誰

智慧家庭愛好者與 Home Assistant 使用者，希望使用自然語言來管理其家庭自動化、建立複雜的自動化流程，並在無需手動編輯設定檔或 UI 的情況下除錯其系統。

重點特色

• 全面控制：管理從裝置、區域到儀表板、藍圖（blueprints）與 HACS 的所有內容。
• 配置管理：透過自然語言建立、編輯與刪除自動化、腳本（scripts）與場景（scenes）。
• 系統除錯：分析自動化追蹤（automation traces）、讀取日誌並檢查系統健康狀況。
• 靈活部署：可作為 Home Assistant OS add-on、Docker 容器或 pip 套件使用。
• 基於搜尋的探索：包含一種模式，讓較小的 LLM 可以按需搜尋工具，而不是將整個目錄載入至上下文（context）中。
• 安全功能：包含唯讀模式（Read Only Mode）、工具安全策略以及針對編輯內容的自動備份功能。