ha-mcp：让 Claude、ChatGPT 直接管理 Home Assistant 的 MCP 服务器

IT
, , ,
1

如果你已经在用 Home Assistant，又习惯让 Claude、ChatGPT 这类助手帮忙干活，ha-mcp 做的就是把两边接起来：它是一个 MCP 服务器，让 AI 助手能直接查看、控制、配置你的 Home Assistant。今天它冲上了趋势榜，一个明显的原因是 9.x 版本把安装方式改成了 Home Assistant 内置的集成，装起来比以前省事得多。

Claude Desktop 里使用 ha-mcp 的演示

它解决什么问题

Home Assistant 的自动化、脚本、仪表盘大多靠手写 YAML 或在界面里一层层点。ha-mcp 把这些操作包装成 87 个 MCP 工具，AI 助手可以按你的自然语言去做。项目给出的例子包括：

  • 「日落时打开门廊灯」：直接创建对应的自动化
  • 「给仪表盘加一张天气卡片」：更新 Lovelace 配置
  • 「动作传感器那个自动化不工作了，帮我查」：读取执行记录，定位问题并给出修改建议
  • 「晨间流程里再加一个开咖啡机」：读出现有自动化，补上动作后写回

能做什么

工具覆盖面比较广：

  • 搜索：实体模糊搜索、配置内容搜索、系统概览
  • 控制：调用任意服务、批量控制设备、读取实时状态
  • 管理：自动化、脚本、辅助实体、仪表盘、区域、分区、日历、蓝图
  • 监控：历史与统计、摄像头截图、自动化执行记录、ZHA 设备
  • 系统：备份与恢复、更新、应用（add-on）、设备注册表

安全方面有只读模式开关、可以按工具单独启用或禁用、工具安全策略（需用户批准），编辑配置时还会自动做备份。让 AI 改家里的自动化，这几项我觉得是必须看一眼的设置。

怎么装

项目现在推荐的方式是 HA-MCP 集成，在 Home Assistant 内部直接运行完整服务，HAOS、Supervised、Container、Core 四种安装类型都支持。要求 Home Assistant 2026.8.0 或更新版本。

  1. 2026.8 到 2026.10：在 HACS 里搜索 HA-MCP 并下载；2026.11 及以上：在 设置 → Marketplace 里搜索安装
  2. 重启 Home Assistant
  3. 准备一个管理员权限的访问方式：可以用自己账号的长期访问令牌，更稳妥的是专门建一个只允许本地登录的管理员账号给它用
  4. 设置 → 设备与服务 → 添加集成，搜索 HA-MCP，选择 HA-MCP Server，填入令牌并选择客户端的连接方式（通过 Home Assistant 的远程 webhook，或局域网直连）
  5. 在配置页复制连接 URL，粘贴到 AI 客户端即可

远程客户端用的是形如 https://<你的域名>/api/webhook/<webhook-id> 的地址；局域网内也可以直连 http://<ha-ip>:9584/private_<随机串>。

其他方式还有 Home Assistant 应用（add-on）、Docker 镜像 ghcr.io/homeassistant-ai/ha-mcp、uvx ha-mcp@latest，以及本地 stdio。项目提醒同一个客户端只配一种安装方式，同时配多个是连接卡住的已知原因；stdio 有已知传输问题，只建议试玩。另外有一个托管的演示环境，不接自己的 Home Assistant 也能先体验。

适合谁，注意什么

适合已经在用 Home Assistant、想让 AI 帮忙写自动化和排错的人。它拿的是管理员级别的权限，连接 URL 本身就相当于凭据，所以别随便泄露，远程访问不需要时直接关掉。另外项目更新很快，README 开头就有一条 v7.3.0 的破坏性变更提示（ha_config_set_yaml 移入 beta），升级前最好看一眼更新说明。

项目信息