非官方Home Assistant MCP服務器

ha-mcp是一個基於模型上下文協議（MCP）的獨立服務器，專為AI助手與Home Assistant智能家居平台深度交互而設計。通過自然語言指令，用户可以實現設備控制、狀態查詢、服務執行以及自動化管理等多種功能。該項目在GitHub上已獲得超過3400顆星和137個分支，社區活躍且更新頻繁。

安裝方式靈活多樣，覆蓋macOS、Linux、Windows和Home Assistant OS等多個平台。macOS和Windows用户可通過簡單的命令行腳本快速安裝並連接至Claude Desktop；Linux用户可選擇社區版Claude Desktop或官方Claude Code；Home Assistant OS用户則可通過官方插件一鍵安裝。此外，還支持通過Nabu Casa或Webhook代理實現遠程訪問，無需額外隧道或端口轉發。

ha-mcp提供多達84種工具，涵蓋搜索與發現、設備控制、管理、監控、系統操作及安全六大類。具體包括模糊實體搜索、深度配置搜索、單設備及批量控制、自動化與腳本管理、儀表板編輯、區域與標籤管理、歷史記錄與統計、攝像頭快照、自動化追蹤、ZHA設備管理、備份恢復、更新管理、插件操作等。安全功能方面，支持只讀模式、按工具啓用/禁用、用户審批策略及自動編輯備份。

與Home Assistant內置的MCP服務器相比，ha-mcp優勢顯著。內置服務器僅能控制已暴露給Assist的實體，而ha-mcp可訪問Home Assistant中所有實體，並支持創建和編輯自動化、腳本、場景、儀表板，調試自動化，管理助手、區域、標籤、分組，以及備份、插件、HACS和設備註冊表。簡言之，內置服務器適合語音控制場景，ha-mcp更適合需要AI助手參與構建和維護智能家居的用户。

此外，ha-mcp還提供可選的beta版自定義組件ha_mcp_tools，用於實現文件系統訪問和YAML配置編輯等高級功能。該組件需通過HACS或手動安裝，並需設置相應的環境變量（如HAMCP_ENABLE_FILESYSTEM_TOOLS=true）方能啓用。安裝後，用户可安全地編輯configuration.yaml文件、讀寫文件等。所有其他工具無需此組件即可正常工作。

總體而言，ha-mcp為Home Assistant用户帶來了強大的AI集成能力，使智能家居的配置與管理變得更加直觀和高效。無論是智能家居新手還是資深玩家，都能借助自然語言與AI助手協作，大幅提升自動化體驗。