homeassistant-ai/ha-mcp

The Unofficial and Awesome Home Assistant MCP Server

解決的問題

AI 助手通常對智慧家庭裝置的存取權限有限。本專案提供了一個全面的 Model Context Protocol (MCP) 伺服器，讓 LLM 能超越簡單的裝置控制，實際使用自然語言來管理、配置與除錯 Home Assistant 實例。

工作原理

該伺服器充當 MCP 相容的 AI 用戶端（如 Claude Desktop、ChatGPT 或 Cursor）與 Home Assistant 安裝實例之間的橋樑。它提供了超過 85 種專業工具，讓 AI 能與系統進行互動。可以透過 Home Assistant 自定義組件、附加元件 (add-on)、Docker 或透過 PyPI 進行安裝。

適用對象

  • 智慧家庭愛好者：希望使用 AI 建立自動化、腳本和場景的使用者。
  • 進階使用者：希望使用執行追蹤和日誌來除錯自動化流程的使用者。
  • 開發者：希望透過自然語言使用 AI 建立與編輯儀表板、管理輔助工具或配置系統設定的使用者。

亮點

  • 深度配置：使 AI 能夠建立/編輯自動化、腳本、場景和儀表板。
  • 系統管理：允許管理附加元件、備份、HACS 和裝置註冊表。
  • 進階除錯：提供存取自動化追蹤、日誌和歷史紀錄的權限，用於故障排除。
  • 廣泛的相容性：支援多種安裝方法，包括進程內自定義組件和 Docker。
  • 安全功能：包含唯讀模式、逐工具啟用/停用選項以及使用者核准策略。