ha-mcp(智能家居)

作者 AI脉搏

想用嘴指挥家里的灯和空调,得先开 App、找设备、翻三层菜单。ha-mcp 把 Home Assistant 接成 MCP 服务,Claude、ChatGPT 能直接改自动化、查状态、写 YAML,推荐用 HACS 装进 HA 进程内,四种安装类型全都支持。

Github
Skill 效率办公 v1.0.0 热度 280

将提示词发送给你的 AI 安装该 Skill

复制下方提示词,粘贴到 Cursor / Claude Code / WorkBuddy 等本地 Agent,按说明安装。

请根据 https://www.cweto.cn/?ai_hub=skill_install ,安装本站 Skill @ai_hub/work-60(ha-mcp(智能家居))。
详情页:https://www.cweto.cn/work-60.html
GitHub:https://github.com/homeassistant-ai/ha-mcp
请装到当前 Agent 的 skills 目录(见安装说明中的路径表),完成后重启或刷新 Agent。
安装说明 GitHub
支持的本地 Agent 目录
  • Claude Code → ~/.claude/skills/
  • Cursor → ~/.cursor/skills/
  • Windsurf → ~/.codeium/windsurf/skills/
  • Codex → ~/.codex/skills/
  • Gemini CLI → ~/.gemini/skills/
  • WorkBuddy → ~/.workbuddy/skills/
  • OpenClaw 变体 → 各自 skills 目录

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 怎么使用

  1. 装好服务端,在 AI 客户端里加一个 MCP 服务指向它(集成方式填 HA 的地址,独立方式填 stdio 命令)。
  2. 直接说人话下达任务:把客厅的灯改成日落前半小时开、查一下卧室湿度、给空调加一条定时。
  3. 需要改 YAML 的复杂配置时,让它读现有配置再改,别让它凭空写。
  4. 用本地小模型(Ollama 等)时,先查它的工具发现说明,否则模型可能挑错工具。
  5. 装自带技能可以让它在自动化这类任务上表现更稳。

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