HA-MCP:让支持 MCP 的助手查询和配置 Home Assistant
一分钟看懂
HA-MCP 把 Home Assistant 的状态查询、设备操作和配置接口提供给智能体。助手可以通过 MCP 这种工具连接协议发现功能、读取状态,并在获准的范围内调用操作。
你可以用它做什么
- 按房间或设备查看智能家居状态。
- 检查指定实体当前的数值与属性。
- 在测试环境中审阅或编辑自动化规则。
- 按需要限制可用工具,先验证只读查询。
主要能力
项目提供 Home Assistant 内部集成,也有独立应用和容器等运行方式。工具覆盖设备和自动化查询、服务调用、配置与诊断;服务器设置支持只读模式、单独启停工具等控制。
适合哪些人
适合已经使用 Home Assistant、能够维护本地网络与账号权限,并希望用助手排查设备状态或管理自动化的用户。
怎么开始使用
先核对 Home Assistant 版本与官方安装路线。进程内服务器要求 2026.8 或以上,可按版本通过 HACS 或 Marketplace 安装。仅选一种服务端方式,在测试环境设置连接,确认访问范围后用只读模式查询一个已知实体,再对照 Home Assistant 页面核验状态。
使用前需要知道
源码采用 MIT。进程内服务以管理员身份访问 Home Assistant,密钥或秘密连接地址泄漏会扩大风险。远程连接与本地直连应按官方方式分别配置;开启写入后,操作可能影响实体状态和自动化。文件与 YAML 编辑需要另行启用。将设备状态交给远程助手时,也应核对该助手的数据处理范围。