ha-mcp

ha-mcp

让 Claude、ChatGPT 等 AI 助手配置并自动化 Home Assistant，通过 HACS 或应用市场作为集成安装。适合自己运行 Home Assistant 的人。

由 homeassistant-ai 在 GitHub 上制作。这些说明是 Mindket 根据其 README 写的，项目自己的文件和许可证在它的仓库里。

简介

它是什么：ha-mcp 把 Claude 和 ChatGPT 这类 AI 助手接入 Home Assistant，让它们能配置并自动化它。推荐的方式是 HA-MCP 集成，它在 Home Assistant 内部运行完整的服务器。它支持 Home Assistant 的全部四种安装类型，每种的功能都相同。

适合谁：自己运行 Home Assistant、想让 AI 助手帮忙设置的人最合适。任何安装类型的自托管用户都能用，因为这个集成在各处表现一致。

行业 | 谁在用 | 怎么用 | 例子
智能家居 | Home Assistant 用户 | 让 AI 助手配置并自动化他们的设置 | 用日常语言请助手建立一个新的自动化
自托管 | OS、Supervised、Container 或 Core 安装的用户 | 把集成加到已有的安装上 | 一条适用于所有安装类型的设置路径
集成工作 | 连接多个助手的人 | 在设置时选择客户端如何连接 | Claude 和 ChatGPT 都连到同一个 Home Assistant

如果你不运行 Home Assistant，可以跳过它。

用在哪里：在你自己的 Home Assistant 里，以 AI 助手作为客户端。

• Home Assistant OS、Supervised、Container 和 Core
• Home Assistant 2026.8 到 2026.10 上的 HACS
• Home Assistant 内置的应用市场，从 2026.11 版本起
• Claude、ChatGPT 和其他 AI 助手作为客户端

用途 | 谁用 | 得到什么
配置 Home Assistant | 家庭用户 | 通过对话完成的设置更改
自动化家居 | 家庭用户 | 通过请助手而创建的自动化
连接另一个助手 | 集成人员 | 可选择每个客户端如何连接

如何设置：你需要一个运行中的 Home Assistant 2026.8.0 或更新版本，以及一个管理员访问令牌。

• Home Assistant 2026.8.0 或更新版本
• 2026.8 到 2026.10 上的 HACS，或 2026.11 及更高版本上的应用市场
• 管理员访问令牌，设置时会要求提供

1. 版本为 2026.8 到 2026.10 时，打开 HACS，查找 HA-MCP 并下载。
2. 版本为 2026.11 或更新时，进入设置，再进入应用市场，接受首次使用时显示的警告。
3. 搜索 HA-MCP 并选择安装。
4. 在设置表单中填入管理员访问令牌，并选择客户端如何连接。

如何使用：集成运行后，你把 AI 助手作为客户端连接，然后请它配置或自动化 Home Assistant。它通过你安装内部的服务器完成工作。

新手与专家：如果你是新手，可以把它看作聊天助手和智能家居之间的桥梁。第一步可以先确认你的 Home Assistant 是 2026.8.0 或更新版本，再安装这个集成。

如果你熟悉这个领域，它是一个在 Home Assistant 内部进程中运行的 Model Context Protocol 服务器，而不是单独的服务。所以各种安装类型的功能一致。代价是它以管理员令牌行事，因此你要谨慎决定哪些客户端可以连接。

你通过 HACS 或应用市场安装 HA-MCP
设置时提供令牌和客户端规则
你的助手作为客户端连接
它配置并自动化 Home Assistant

注意事项：版本 7.3.0 把设置 YAML 配置的工具移到了测试版。从 9.0.0 起会出现管理员账号这一步，更早的版本表单更短。

• License: MIT
• Cost to run: 一个 Home Assistant 安装和一个管理员访问令牌。来源没有提到付费服务。
• Data it reaches: 通过管理员令牌访问你的 Home Assistant 安装，让助手能更改它的配置。
• Not for: 比 2026.8.0 更旧的 Home Assistant。

GitHub 上的数据（2026年11月10日）

• 星标：6,025（当天 31）
• 复刻：295
• 关注：20
• 未关闭的议题和拉取请求：24
• 语言：Python
• 许可证：MIT
• 话题：ai, claude, hacs, home-assistant, home-automation, llm, mcp, model-context-protocol
• 趋势：GitHub 趋势榜当日第 10 名（2026年11月10日）

链接

• 代码：https://github.com/homeassistant-ai/ha-mcp
• 网站：https://homeassistant-ai.github.io/ha-mcp/
• 发布版本：https://github.com/homeassistant-ai/ha-mcp/releases
• 议题：https://github.com/homeassistant-ai/ha-mcp/issues
• 星标历史：https://www.star-history.com/#homeassistant-ai/ha-mcp&Date

获取代码

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

然后按它的 README 完成设置。这个工具包里没有会自己运行的东西。