# Home Assistant MCP 服务器

非官方且功能强大的 Home Assistant 模型上下文协议（MCP）服务器。让 Claude、Cursor 和 Gemini 等 AI 助手能够使用自然语言控制你的智能家居——包括灯光、传感器、自动化、仪表盘等功能。

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

Language: zh

Category: MCP Servers

Updated: 2026-04-01

## 概述

**ha-mcp**（非官方且出色的 Home Assistant MCP 服务器）是一个领先的社区构建的模型上下文协议服务器，它将你的 Home Assistant 实例转化为 AI 助手的强大工具。它允许像 Claude、Cursor、Gemini CLI 这样的 LLMs 以及任何兼容 MCP 的客户端直接通过自然语言与你的智能家居交互。

尽管 Home Assistant 现在包含一个官方的 `mcp_server` 集成，ha-mcp 提供了显著更丰富的功能（80 多种工具）、一个简便的 HA OS 插件和一个专门的设置向导，使其成为大多数用户的首选。

## 核心功能

] 自然语言控制：开关灯、调节气候、打开覆盖物、播放媒体，并执行任何服务。
] 实时状态与实体查询：询问传感器数值、设备状态或完整的家庭摘要。
] 自动化管理：动态创建、编辑、启用/禁用、触发或暂停自动化。
] 高级功能：YAML 编辑、HACS 管理、Lovelace 仪表板生成、更新处理、备份以及 80 多种专业工具。
] 多客户端支持：与 Claude Desktop、Cursor、VS Code + Cline、Gemini CLI 等无缝协作。
] 简便安装：官方 HA OS 插件、Docker 或快速运行选项。
] 安全可靠：使用具有适当身份验证的长效访问令牌。

## 使用场景

] 免操作智能家居："关闭楼下所有的灯并锁上前门。"
] AI 驱动的自动化："创建一个在日落时打开门廊灯并通知我的自动化。"
] 仪表板与配置编辑：让 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、容器、核心）。
] 许可证：开源（请查看仓库了解具体条款）。

## 社区与替代方案

这是功能最丰富且维护最活跃的版本（截至2026年3月，版本为v7.1.0+）。社区中虽存在其他分支版本，但来自homeassistant-ai组织的ha-mcp是论坛、YouTube和Reddit上最受推荐的版本。

针对轻量级使用场景，也可选择官方Home Assistant提供的`mcp_server`集成方案。

立即开始用AI掌控您的智能家居——ha-mcp让这一切变得简单、强大且充满乐趣。

## Tags

- 家庭助理
- MCP
- 智能家居
- 家庭自动化
- 人工智能集成
- Claude
- Cursor
- 物联网
- 大语言模型
- 自动化

## Sources

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