Home Assistant MCP 伺服器

概覽

ha-mcp (非官方且超好用的 Home Assistant MCP 伺服器) 是領先的社群開發 Model Context Protocol 伺服器，它能將您的 Home Assistant 實例轉變為 AI 助理的強大工具。它允許 Claude、Cursor、Gemini CLI 等 LLM，以及任何 MCP 相容的客戶端，直接使用自然語言與您的智慧家庭互動。

雖然 Home Assistant 現在包含官方的 mcp_server 整合，但 ha-mcp 提供了更豐富的功能（80 多種工具）、簡單的 HA OS 附加元件和專用的設定精靈，使其成為大多數用戶的首選。

主要功能

-Highlight：自然語言控制：開啟/關閉燈光、調整氣候、開啟覆蓋物、播放媒體，以及執行任何服務。

• 即時狀態與實體查詢：詢問感測器數值、裝置狀態或完整的家庭摘要。

1. 自動化管理：動態建立、編輯、啟用/停用、觸發或暫停自動化。
2. 進階功能：YAML 編輯、HACS 管理、Lovelace 儀表板生成、更新處理、備份以及 80 多種專用工具。

• 多客戶端支援：與 Claude Desktop、Cursor、VS Code + Cline、Gemini CLI 等無縫協作。
• 簡易安裝：提供官方 HA OS 附加元件、Docker 或快速執行選項。
• 安全可靠：使用具有適當認證的長期有效存取權杖。

使用案例

• 免動手智慧家庭：「關掉樓下所有的燈並鎖上前門。」
• AI 驅動自動化：「建立一個在日落時開啟門廊燈光並通知我的自動化。」 -g. 儀表板與配置編輯：讓 Cursor 或 Claude 生成並部署 Lovelace 儀表板或 YAML 配置。
• 監控與故障排除：「臥室目前的溫度是多少？為什麼動作感測器離線了？」
• 複雜工作流程：結合其他 MCP 伺服器，實現完整的 AI 協調家庭 + 開發流程。

安裝（最簡單方法）

Home Assistant OS 附加元件

1. 在您的 HA 附加元件商店中添加儲存庫 https://github.com/homeassistant-ai/ha-mcp 。
2. 安裝並啟動 Home Assistant MCP Server 附加元件。
3. 生成一個長期有效的存取權杖並進行配置。
4. 使用官方設定精靈：https://homeassistant-ai.github.io/ha-mcp/setup/

替代方案：Docker、uvx 或從儲存庫手動安裝。

相容性

-[. 客戶端：Claude Desktop、Cursor、Gemini CLI、Codex、任何 MCP 相容應用程式。

• Home Assistant：適用於目前的 HA 版本（OS、Container、Core）。
• 授權：開源（請查閱儲存庫了解確切條款）。

社群與替代方案

這是目前維護最活躍、功能最豐富的版本（截至 2026 年 3 月為 v7.1.0+）。雖然存在其他社群分支版本，但來自 homeassistant-ai 組織的 ha-mcp 是各大論壇、YouTube 和 Reddit 最普遍推薦的版本。

若需輕量級使用方案，亦可選擇官方的 Home Assistant mcp_server 整合套件。

立即透過 AI 開始操控您的智慧家居——ha-mcp 讓這一切變得簡單、強大且充滿樂趣。