# Home Assistant MCP 伺服器

非官方且功能強大的 Home Assistant 模型情境協定 (MCP) 伺服器。讓 Claude、Cursor、Gemini 等 AI 助手能夠使用自然語言控制您的智慧家庭系統 — 燈光、感測器、自動化功能、儀表板等。

Canonical URL: https://a2a-mcp.org/entry/home-assistant-mcp-server-zh-TW

Language: zh-TW

Category: MCP Servers

Updated: 2026-04-01

## 概覽

**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 讓這一切變得簡單、強大且充滿樂趣。

## Tags

- home-assistant
- mcp
- 智慧家庭
- 家庭自動化
- AI整合
- claude
- cursor
- iot
- llm
- 自動化

## Sources

- [Project website](https://github.com/homeassistant-ai/ha-mcp)