非官方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助手協作，大幅提升自動化體驗。