Home Assistant + Home Assistant OS / Supervised / Container / Core+ HACS+ HA-MCP Custom Component+ Claude Desktop
通过 HACS 集成让 MCP 服务进程内运行,AI 客户端用自然语言控制智能家居
HACS 分发集成,HA-MCP 作为 Custom Component 在 HA 进程内运行,通过 webhook URL 让 AI 客户端连接
✓ 无需管理 access token✓ 支持所有 HA 安装类型 ✕ 必须独占,不能与其他安装方式并存
方案简介
通过 HACS 集成让 MCP 服务进程内运行,AI 客户端用自然语言控制智能家居。HACS 分发集成,HA-MCP 作为 Custom Component 在 HA 进程内运行,通过 webhook URL 让 AI 客户端连接
组成与分工
- HACS (Home Assistant Community Store):作为 Home Assistant 的第三方商店,负责分发 HA-MCP Custom Component,允许用户通过自定义仓库添加并下载集成。
- HA-MCP Custom Component (custom_components/ha_mcp_tools):本项目的核心组件,以 in-process 方式在 Home Assistant 主进程中运行完整的 MCP 服务器,并提供 webhook 端点供 AI 客户端连接。
- Home Assistant:作为智能家居平台,承载集成运行与设备状态数据,组件会接管服务调用与实体查询。
- AI 客户端(如 Claude Desktop):通过 MCP 协议连接到 HA-MCP 服务器,把用户的自然语言指令翻译为对 Home Assistant 的服务调用。
- Home Assistant Webhook / 直连端口:作为连接通道,远程客户端走 webhook URL(
/api/webhook/),同网客户端走直连端口(http://:9584/private_)。 - HA-MCP 设置面板:组件启用后,管理员侧边栏出现 HA-MCP 面板,可管理工具开关、备份与主题。
前置要求
- 一台已经运行的 Home Assistant 实例(支持 Home Assistant OS、Supervised、Container、Core 任一类型)。
- 已安装 HACS 社区商店。
- 一个支持 MCP 协议的 AI 客户端(Claude Desktop、Claude.ai、ChatGPT 等)。
- 若使用 Nabu Casa 或反向代理的远程访问,需要已配置好对应的域名/证书;若仅本地使用,可关闭 webhook 远程访问。
- 无需额外安装 access token,认证由 Home Assistant 自身或 webhook 秘密 URL 完成。
优缺点
- ✓ 无需管理 access token
- ✓ 支持所有 HA 安装类型
- ✕ 必须独占,不能与其他安装方式并存
出处
本方案挖掘自开源项目 homeassistant-ai/ha-mcp，方案内容与实施命令均来自其 README 原文。
方案出处
homeassistant-ai/ha-mcp：The Unofficial and Awesome Home Assistant MCP Server 4653 star The Unofficial and Awesome Home Assistant MCP Server
本方案由真实开源项目挖掘整理，实施命令均来自其 README 原文，安装使用请遵循项目开源协议。