📌 项目地址：homeassistant-ai/ha-mcp | ⭐ 5,744 颗星 | 🔧 Python
这个项目解决什么问题
用 Home Assistant 的人大多经历过：想加一个自动化，先翻文档查触发器写法，再去找实体 ID，最后跟 YAML 的缩进搏斗。HA-MCP 的思路很直接：把这些活交给 AI。它是一个 MCP 服务器，装好之后，Claude、ChatGPT 这类助手可以直接读写你的 Home Assistant 配置、帮你创建自动化。你用自然语言说需求，AI 负责落地。
项目用 Python 写，star 已经奔着六千去，迭代很快，README 里的快捷指南写的是 2026 年 10 月 28 日发布的 v9.0.0。有一个细节值得留意：v7.3.0 把 ha_config_set_yaml 挪进了 beta（见仓库的 docs/beta.md），说明直接写配置这类功能还在调整，升级前最好看一眼 changelog。
怎么装：认准集成方式
README 推荐的安装方式只有一个：HA-MCP 集成。它跑在 Home Assistant 进程里，而且不管你用的是 HA OS、Supervised、Container 还是 Core，功能完全一样，没有阉割版。
前置条件是 Home Assistant 2026.8.0 或更新版本。安装路径分两条：
- HA 2026.8 到 2026.10：打开 HACS，搜 HA-MCP，点 Download。
- HA 2026.11 及以后：打开 Settings → Marketplace，接受首次运行警告，搜 HA-MCP 后点 Install。它已经进了默认目录，不用连 GitHub，也不用加自定义仓库，后续更新同样走这里。
装完重启 Home Assistant。
老用户注意：如果你是从早期的 homeassistant-ai/ha-mcp-integration 仓库装的，更新照常推送；设备列表里可能还显示旧名字 HA-MCP Custom Component，搜索 HA-MCP 两个名字都能找到。
关键决定：让服务器用哪个身份
这一步是整个配置里最需要认真对待的地方，因为它决定 AI 拿到的权限有多大。README 给了两条路。
第一条：在你自己的账户下创建长期访问令牌（Profile → Security → Long-lived access tokens → Create token）。方便，但 README 把话说得很明白：这个令牌一旦泄露，任何地方都能用，而且服务器的所有操作都会记在你名下。
第二条更安全，也是我建议的做法：在 Settings → People → Add person 里给 HA-MCP 单独建一个账户，勾上 Allow login、Local access only 和 Administrator。这样权限有边界，日志也分得清哪些改动是 AI 做的。README 特别强调，走这条路时绝不要填你自己的登录密码。
最后一步：配置连接
进入 Settings → Devices & Services → Add Integration，搜 HA-MCP，选 HA-MCP Server。粘贴令牌，或者输入刚才建的专用账户的用户名密码（HA-MCP 会自己生成令牌），然后选客户端的连接方式。连接方式里有一项 Remote access through Home Assistant，入门建议从 Secret URL 开始，它是几种方式里配置最简单的。
我的看法
这个项目的价值取决于你对两件事的态度。一是你改自动化的频率：如果每次都要查半天文档，AI 直接生成自动化能省下实打实的时间。二是权限问题：你交给 AI 的是管理员级别的家庭控制权，专用账户加 Local access only 已经把风险压到比较低的水平，但边界始终要自己守。
版本太旧升不上去的，或者对“AI 拿管理员权限”心里没底的，可以先观望。其他人，装之前把上一节那个身份问题想清楚，剩下的都很顺。