Skill 说明
ha-mcp 是什么
ha-mcp 是一个 MCP 服务端,作用是把 Home Assistant 交给 AI 助手来操作。装好之后,Claude、ChatGPT 这类支持 MCP 的客户端可以直接查设备状态、修改自动化、编辑 YAML 配置,而不用你在 App 里一层层点。
官方现在推荐的方式是通过 HA-MCP integration 安装:它在 Home Assistant 里走 HACS(Home Assistant 2026.11+ 自带的应用市场),把完整服务跑在 HA 进程内,支持 Home Assistant OS、Supervised、Container、Core 四种安装类型,功能完全一致。安装时它会要一个管理员访问令牌,并问你客户端要怎么连。
| 安装方式 | 适用场景 |
|---|---|
| HA-MCP 集成(推荐) | 走 HACS 装进 HA 进程内,四种 HA 安装类型都支持,功能齐全 |
| Home Assistant 应用(add-on) | 适合支持 add-on 的 HA OS / Supervised |
| Docker / PyPI(uvx,stdio) | 独立进程跑,客户端按 stdio 连 |
| 演示服务端 | Windows / macOS / Linux 上先试效果 |
一个必须守住的规则:每个客户端只能配一种安装方式。集成、add-on、Docker/PyPI、本地 stdio 都是同一套服务端的不同跑法,同时开两个会互相打架。它还附带了给 Agent 用的技能(bundled skills),并提供了工具发现机制,方便本地小模型(如 Ollama)也能正确挑工具。
ha-mcp 怎么安装
首选在 Home Assistant 里装 HA-MCP integration:先在 HACS 里添加,装完按向导填管理员访问令牌。
不想动 HA 的话,可以用 PyPI 方式在本地起 stdio 服务:
uvx ha-mcp
也可以用 Docker 跑一份独立服务端。仓库里还提供了一个演示服务端,Windows / macOS / Linux 都能直接起,用来先看看它能干什么再决定要不要接自家环境。
仓库还有一个 Setup Wizard,覆盖 15 个以上客户端的配置,照着填就能连上,不用自己拼 MCP 配置。
ha-mcp 怎么使用
- 装好服务端,在 AI 客户端里加一个 MCP 服务指向它(集成方式填 HA 的地址,独立方式填 stdio 命令)。
- 直接说人话下达任务:把客厅的灯改成日落前半小时开、查一下卧室湿度、给空调加一条定时。
- 需要改 YAML 的复杂配置时,让它读现有配置再改,别让它凭空写。
- 用本地小模型(Ollama 等)时,先查它的工具发现说明,否则模型可能挑错工具。
- 装自带技能可以让它在自动化这类任务上表现更稳。
ha-mcp 适合谁用
- 已经用 Home Assistant 打理家居、想让 AI 帮忙写自动化和改配置的人。
- 用 Claude、ChatGPT 等支持 MCP 的客户端,希望语音或聊天直接控制设备。
- 不想在手机 App 里翻菜单、只想说一句话就改状态的懒人。
- 用本地小模型但想接家居控制的自建玩家。
- 没在用 Home Assistant、或者设备根本没接入中枢的场景,用不上它。
ha-mcp 项目地址
- GitHub 仓库:https://github.com/homeassistant-ai/ha-mcp
- 官方文档:https://homeassistant-ai.github.io/ha-mcp/
- Home Assistant:https://www.home-assistant.io
- HACS:https://hacs.xyz