社群維護的開源專案 homeassistant-ai/ha-mcp 是 Home Assistant 的 Model Context Protocol(MCP)伺服器,讓 AI 助手不只是讀取家居狀態,還能建立與編輯自動化、場景與儀表板。該專案同時出現於 GitHub Trending 的每日全語言分榜與 Python 每日分榜。
社群規模與使用量
GitHub API 快照顯示,homeassistant-ai/ha-mcp 累積 7650 stars、462 forks、24 watchers 與 14 open issues,於 2025-09-14T13:23:45Z 建立,最近推送時間為 2026-11-12T12:48:17Z。PyPI 統計顯示,套件近一日下載 28891 次、近一星期 222709 次、近一個月 229725 次。
工具目錄與搜尋模式
README 說明,工具目錄涵蓋約 87 項,可用 BM25 搜尋模式取代完整工具清單,讓 AI 助手按需要逐步探索可用能力,而不是一次載入全部介面。功能範圍包括讀取狀態以外的配置維護工作:建立與編輯自動化與場景、讀取追蹤記錄與歷史、管理 helper、執行備份、應用變更,以及 HACS 安裝。內建安全護欄包括 Read Only Mode、每次工具啟用開關,以及編輯前的自動備份。
安裝與整合方式
官方文件提供 Setup Wizard,會按安裝方式與所用 AI 客戶端配對設定指引;官方建議透過 HACS,或使用 Home Assistant 2026.11 起的 Marketplace 安裝整合。
版本與維護活動
穩定版 v9.2.0 於 2026-11-11T16:20:14Z 發布,內容包括以 Home Assistant 自身流程處理 helper、改以 Python 3.14 建置並在真實 Home Assistant Core 上執行單元測試,以及以精確比對搜尋取代編輯儲存文字檔。repository 於 2026-11-12T12:48:17Z 仍有推送,同日亦發布 v9.3.0.dev3511 等開發版本。
授權狀況
GitHub API 的 license.spdx_id 回傳 MIT,repository 內 LICENSE 檔案為 MIT License 全文(Copyright (c) 2024 Julien),PyPI 套件頁同樣標示 License MIT。
安全說明與操作範圍
SECURITY.md 的威脅模型訂明,已通過驗證的 MCP 客戶端視為受信任主體,提示注入的防範屬客戶端責任,python_transform 運算式則視為受信任客戶端的程式碼。標準模式的 HTTP 端點以 URL 路徑密碼驗證,只適用於 loopback 或區域網路。v9.2.0 已把每項 ha_mcp_tools 服務改為僅限管理員註冊,並遮蔽 Core 標示為機密的流程欄位。本次並未安裝或執行此工具。
社群討論
Home Assistant 社群討論串持續比較內建 MCP Server 與 ha-mcp 的職責分界,另一篇討論則集中於 Claude、ChatGPT 與 ha-mcp 的整合體驗;Home Automation Weekly 亦刊出專題,比較 Home Assistant MCP Server 與 ha-mcp 的差異。
來源
- GitHub 專案與 README:https://github.com/homeassistant-ai/ha-mcp
- v9.2.0 發布說明:https://github.com/homeassistant-ai/ha-mcp/releases/tag/v9.2.0
- SECURITY.md:https://github.com/homeassistant-ai/ha-mcp/blob/master/SECURITY.md
- LICENSE(MIT):https://github.com/homeassistant-ai/ha-mcp/blob/master/LICENSE
- 官方 Setup Wizard:https://homeassistant-ai.github.io/ha-mcp/setup/
- PyPI 套件頁:https://pypi.org/project/ha-mcp/
- Home Assistant 社群討論串:https://community.home-assistant.io/t/how-do-you-use-ai-with-home-assistant/1028637
- Home Assistant 社群整合討論串:https://community.home-assistant.io/t/brand-new-claude-ai-chatgpt-integration-ha-mcp/937847
- Home Automation Weekly 專題:https://homeautomationweekly.com/issues/12-home-assistant-mcp-server-vs-ha-mcp
- Glama MCP 伺服器頁:https://glama.ai/mcp/servers/homeassistant-ai/ha-mcp
圖片說明:封面為 HKAIWeb 原創,以 prompt-only 方式生成,未附帶任何第三方參考素材,授權為 CC BY 4.0。