homeassistant-ai/ha-mcp

如果你已经在运行 Home Assistant，又想让对话客户端帮你改配置，这个项目值得一看；但请把它当作管理员工具，而不是随手的语音助手。推荐的安装方式把服务端放进 Home Assistant 内部，能力远超只控制已暴露实体的语音式接入。

解决什么问题

Home Assistant 用户想新增一条自动化、调整仪表盘或查询历史时，通常要手写 YAML、翻找实体 ID。内置 Assist 只能处理已暴露的实体和它理解的意图，新建和维护配置仍要回到文件或界面。ha-mcp 改掉了这一步：对话客户端先搜索实体和配置，再调用工具创建自动化、修改仪表盘、管理辅助实体、读取历史。最终得到的是一处真正生效的改动，而不是手工编辑。

有什么不同

项目暴露的 MCP 工具面很宽，README 标称 87 个工具，覆盖搜索、服务调用、自动化和辅助实体管理、仪表盘、备份、更新以及 ZHA 设备。README 专门对比了 Home Assistant 自带的 MCP Server 集成：后者基于 Assist 管线，只能触及暴露给 Assist 的实体和它支持的意图。这意味着 ha-mcp 能碰到前一种接法碰不到的配置和管理面。

更值得注意的是它的防护层：只读模式、按工具启停、可要求用户确认的工具策略，以及自动编辑备份。README 还说明了模板辅助实体的备份与恢复，但带有前提：捕获时如果脱敏不完整会拒绝执行；恢复辅助实体需要新的安全备份；快照中不存在的可选设置会在恢复时被移除。这些是实用护栏，不是“万无一失可回滚”的保证。代价是复杂度：能力越大，需要配对的设置越多，工具清单也长到必须依赖各客户端的配置指引。

谁值得试

适合：已经熟悉实体、自动化和备份的 Home Assistant 老用户，想要一个能力较强的助手客户端来改配置，并愿意检查工具权限。从只读模式开始比较稳妥。不适合：只想用语音控制几盏灯的人，或者不愿意管理管理员级令牌、也不想弄清客户端到底能改什么的人。

安装路径会改变适用人群。HA-MCP 自定义组件通过 HACS 安装、在进程内运行，支持 Home Assistant OS、Supervised、Container 和 Core，安装时要求管理员令牌。应用（附加组件）方式在 OS 和 Supervised 上无需管理令牌。Container 和 Core 用户则要运行 Docker、PyPI/uvx 或本地 stdio，并用安装向导生成客户端配置。文档还覆盖远程访问的 OIDC，也可以先用托管演示环境试水。

使用条件与边界

你需要一个运行中的 Home Assistant 和一个支持 MCP 的客户端；向导列出了 Claude Code、Gemini CLI、ChatGPT、Open WebUI、VS Code、Cursor 等。推荐安装需要 HACS 和管理员凭据；非管理员令牌可用但有文档说明的限制，这直接影响你能否把助手约束在权限范围内。

日常维护不能忽略。README 提到 v7.3.0 的破坏性变更把 ha_config_set_yaml 移入 beta，升级前应固定版本并读发布说明。备份确实存在，但辅助实体的恢复有条件，且会删除快照中没有的设置。通过密钥 URL 或 OIDC 开放远程访问会扩大暴露面；README 说明目前不收集遥测，但计划未来加入，会遵循 Home Assistant 的分析设置并提前通知。

HotRepo 点评

HotRepo 只有一条带日期的记录：2026-10-26 为 5,259 星，当天增加 36，并在新项目榜排名第 5。单个快照不足以判断热度能否持续。落地前请对照你打算运行的版本，核对该工具的 beta 状态和发布说明。