Home Assistant MCP 服务器

概述

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让这一切变得简单、强大且充满乐趣。