HKAIWeb 原創封面:深色桌面上的黑色圓柱形智慧家居中樞,向外出現青綠色同心訊號光紋

社群維護的開源專案 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。

作者: hkaiweb

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *

Social Media Auto Publish Powered By : XYZScripts.com