Home Assistant ha-mcp and Claude part1 - 方案选型

用Claude 维护ha的第一步，是要安装一个ha mcp server，这里涉及到ha mcp server的选型。

 

环境

RPi5 8GB+ Home Assistant Docker

 

选型结果

先说结论，最终采用下面的组合：

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

Claude Code

 

选型过程

 

当MCP 发布

1.Home Assistant 官方 发布了内置的mcp server

但AI 根本无法修改配置文件，仅仅n用于控制设备。

 

2.于是，很多作者都写了自己的实现.

zorak1103/ha-mcp

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

 

3.后来，又出来一个

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

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

结论：选https://github.com/homeassistant-ai/ha-mcp

 

 

官方 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

第二部分，来说一下，homeassistant-ai/ha-mcp怎么用。有两种部署方式。

旧的（2025）

Claude
    │
    ▼
Docker ha-mcp
    │
    ▼
Home Assistant

需要自己维护Docker

 

New（2026，推荐）

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

结论：

1.选ha-mcp Server 就运行在 Home Assistant 里面的安装方式

2.弃用 HA-MCP Docker的安装方式。

 

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