Home Assistant ha-mcp and Claude

 

环境

RPi5 + Home Assistant Docker

 

采用下面的组合：

Home Assistant Docker
        │
        ▼
HACS
        │
        ▼
ha-mcp-integration
        │
        ├──  HA MCP Server
        │
        └──  HA MCP File & YAML Tools
        │
        ▼

Claude Code

 

 

当MCP 刚发布，很多作者都写了自己的实现.

zorak1103/ha-mcp

这是 第一代 Home Assistant MCP Server,目前基本停止维护（早期项目)

官方 MCP Server、ha-mcp、ha-mcp-integration 三者关系

Home Assistant 官方 mcp

AI 根本无法修改配置文件。

 

于是，很多作者都写了自己的ha mcp server实现，其中：

homeassistant-ai/ha-mcp

https://github.com/homeassistant-ai/ha-mcp

已经远超第一代 MCP，非常活跃，持续跟随 HA 更新

自动化：

create_automation
update_automation
reload_automation

 

结论

直接使用 homeassistant-ai/ha-mcp，不要再考虑 zorak1103/ha-mcp

 

How to use

旧的（2025）

Claude
    │
    ▼
Docker ha-mcp
    │
    ▼
Home Assistant

需要自己维护Docker

 

New（2026，推荐）

Claude
    │
    ▼
Home Assistant
    │
HA MCP Server
(内置)

不需要 Docker，ha-mcp Server 就运行在 Home Assistant 里面

 

 

ha-mcp-integration vs ha_mcp_tools

现在安装 HACS 时，推荐安装的就是 ha-mcp-integration，它里面仍然包含 custom_components/ha_mcp_tools

 

最新的 ha-mcp-integration 已经内置了完整的 MCP Server。

ha-mcp-integration
│
├── HA MCP Server
│      │
│      └── 完整 MCP Server
│
└── HA MCP File & YAML Tools
       │
       └── 文件和 YAML 操作能力

当你需要用 AI 直接修改 configuration.yaml、packages、automations.yaml 等文件时，需要再添加 HA MCP File & YAML Tools

结论

不需要再运行 Docker 版 ha-mcp