ha-mcp是一个全面的模型上下文协议（MCP）服务器，旨在使AI助手能够与Home Assistant互动。它允许用户使用自然语言控制智能家居设备、查询状态、执行服务以及管理自动化。

ha-mcp 是开源的吗？

是的，采用 MIT 许可证。

ha-mcp

Q: ha-mcp 是开源的吗？

是的，采用 MIT 许可证。

活跃·★ 5.2k·MIT·更新于 2026-10-21

★ 必备神器★ 时下流行

ha-mcp 自称是非官方的、很棒的 Home Assistant MCP 服务：一个全面的 Model Context Protocol 服务，让 AI 助手用自然语言与 Home Assistant 交互，控制设备、查询状态、执行服务并管理自动化。配合 Claude Desktop 的设置指南大约需要五到十分钟（不需要付费订阅），提供 macOS 和 Linux 的安装脚本、支持 15 种以上客户端的设置向导，以及可以在连接自己的 Home Assistant 之前先对话体验的演示环境。

README 把它与 Home Assistant 内置的 MCP Server 做了对比：内置的基于 Assist 流水线，只能访问暴露给 Assist 的实体；ha-mcp 是独立服务，面向配置、构建和调试：Home Assistant 里的一切都在范围内，它可以创建和编辑自动化、脚本和场景，编辑仪表盘，根据轨迹调试自动化，读取历史和日志，管理辅助实体、区域、地带和分组，处理备份、加载项、HACS 以及设备和实体注册表。完整工具列表有 84 个工具，安全功能包括只读模式开关、按工具启用或禁用、需要用户批准的工具安全策略，以及编辑的自动备份。v7.3.0 的一个破坏性变更把 ha_config_set_yaml 移到了测试版。代码采用 MIT 许可证。

#Home Assistant#智能家居#AI助手#MCP服务器#自动化#自然语言#设备控制#LLM集成

功能特性

01通过自然语言控制智能家居设备和服务。

02管理Home Assistant的自动化、脚本、助手和仪表板。

03监控和调试Home Assistant系统，包括历史记录、日志和自动化追踪。

04全面的实体和配置搜索功能。

05内置安全功能，如只读模式和工具安全策略。

为什么选择它

+不止于设备控制：可以创建和编辑自动化、脚本、场景和仪表盘，并根据轨迹调试自动化。

+能访问 Home Assistant 里的一切，而不只是暴露给 Assist 的实体（README 与内置 MCP Server 的对比）。

+安全控制：只读模式、按工具启用或禁用、需要用户批准的工具安全策略、编辑自动备份。

+有引导式安装脚本和支持 15 种以上客户端的设置向导，可先在演示环境里体验，采用 MIT 许可证。

权衡点

!这是非官方的第三方项目，不属于 Home Assistant 本身。

!84 个工具对自动化、仪表盘和加载项有写入权限，意味着助手可以改变你的家居配置，在信任它之前请开启只读模式或批准策略。

!部分工具仍处于测试阶段（例如 v7.3.0 起移到测试版的 ha_config_set_yaml），不同版本之间行为可能变化。

维护状况检查

活跃检查日期: 2026-10-20

最近提交: 2026-10-20
近 90 天提交数: 100+
近 90 天发布数: 18
最新发布: v9.0.0.dev3117 (2026-10-20)
未关闭 issue: 13
近期 issue 至少有一条评论的比例: 16/16

近 12 周每周提交数

最早的一周在左边，最近 4 周为橙色。数据来源：GitHub 提交统计。

状态规则：GitHub 上已归档 = 已归档；最近提交在 90 天内 = 活跃；91 到 365 天 = 放缓；更久 = 停滞。所有数字来自所示日期的 GitHub API。

讨论最多的未关闭 issue

#2632 [FEATURE] Use native HA Core APIs, schemas, and flows for read and write tools17 条评论 · 2026-10-03
#1237 Dependency Dashboard8 条评论 · 2026-05-11
#2653 [FEATURE] Webhook Proxy app: callback allowlist for none-mode OAuth auto-approve4 条评论 · 2026-10-04
#2750 [FEATURE] ha_manage_energy_prefs: add remove_source / replace_source modes for energy_sources3 条评论 · 2026-10-16
#2786 [FEATURE] ha_manage_backup create: use the backup locations configured in Home Assistant (or accept agent_ids)2 条评论 · 2026-10-19

issue 标题引自 GitHub。请打开链接确认该问题是否仍适用于你使用的版本。

兼容性

Python

运行时

已通过文档验证

Home Assistant

平台

已通过文档验证

MacOS

操作系统

已通过文档验证

Linux

操作系统

已通过文档验证

Windows

操作系统

已通过文档验证

Home Assistant OS

附加组件

已通过文档验证

快速开始

$ curl -LsSf https://raw.githubusercontent.com/homeassistant-ai/ha-mcp/master/scripts/install-macos.sh | sh

使用场景

↳根据自然语言指令创建和修改Home Assistant自动化。

↳通过分析自动化追踪和系统日志来调试智能家居问题。

↳通过单个自然语言请求控制多个设备或执行复杂例程。

↳添加或更新UI元素，例如仪表板卡片。

↳管理Home Assistant的配置，例如区域、分区和辅助实体。

ha-mcp

活跃·★ 5.2k·MIT·更新于 2026-10-21

★ 必备神器★ 时下流行

#Home Assistant#智能家居#AI助手#MCP服务器#自动化#自然语言#设备控制#LLM集成

功能特性

01通过自然语言控制智能家居设备和服务。

02管理Home Assistant的自动化、脚本、助手和仪表板。

03监控和调试Home Assistant系统，包括历史记录、日志和自动化追踪。

04全面的实体和配置搜索功能。

05内置安全功能，如只读模式和工具安全策略。

为什么选择它

+不止于设备控制：可以创建和编辑自动化、脚本、场景和仪表盘，并根据轨迹调试自动化。

+能访问 Home Assistant 里的一切，而不只是暴露给 Assist 的实体（README 与内置 MCP Server 的对比）。

+安全控制：只读模式、按工具启用或禁用、需要用户批准的工具安全策略、编辑自动备份。

+有引导式安装脚本和支持 15 种以上客户端的设置向导，可先在演示环境里体验，采用 MIT 许可证。

权衡点

!这是非官方的第三方项目，不属于 Home Assistant 本身。

!84 个工具对自动化、仪表盘和加载项有写入权限，意味着助手可以改变你的家居配置，在信任它之前请开启只读模式或批准策略。

!部分工具仍处于测试阶段（例如 v7.3.0 起移到测试版的 ha_config_set_yaml），不同版本之间行为可能变化。

维护状况检查

活跃检查日期: 2026-10-20

最近提交: 2026-10-20
近 90 天提交数: 100+
近 90 天发布数: 18
最新发布: v9.0.0.dev3117 (2026-10-20)
未关闭 issue: 13
近期 issue 至少有一条评论的比例: 16/16

近 12 周每周提交数

最早的一周在左边，最近 4 周为橙色。数据来源：GitHub 提交统计。

状态规则：GitHub 上已归档 = 已归档；最近提交在 90 天内 = 活跃；91 到 365 天 = 放缓；更久 = 停滞。所有数字来自所示日期的 GitHub API。

讨论最多的未关闭 issue

#2632 [FEATURE] Use native HA Core APIs, schemas, and flows for read and write tools17 条评论 · 2026-10-03
#1237 Dependency Dashboard8 条评论 · 2026-05-11
#2653 [FEATURE] Webhook Proxy app: callback allowlist for none-mode OAuth auto-approve4 条评论 · 2026-10-04
#2750 [FEATURE] ha_manage_energy_prefs: add remove_source / replace_source modes for energy_sources3 条评论 · 2026-10-16
#2786 [FEATURE] ha_manage_backup create: use the backup locations configured in Home Assistant (or accept agent_ids)2 条评论 · 2026-10-19

issue 标题引自 GitHub。请打开链接确认该问题是否仍适用于你使用的版本。

兼容性

Python

运行时

已通过文档验证

Home Assistant

平台

已通过文档验证

MacOS

操作系统

已通过文档验证

Linux

操作系统

已通过文档验证

Windows

操作系统

已通过文档验证

Home Assistant OS

附加组件

已通过文档验证

快速开始

$ curl -LsSf https://raw.githubusercontent.com/homeassistant-ai/ha-mcp/master/scripts/install-macos.sh | sh

使用场景

↳根据自然语言指令创建和修改Home Assistant自动化。

↳通过分析自动化追踪和系统日志来调试智能家居问题。

↳通过单个自然语言请求控制多个设备或执行复杂例程。

↳添加或更新UI元素，例如仪表板卡片。

↳管理Home Assistant的配置，例如区域、分区和辅助实体。

ha-mcp

功能特性

为什么选择它

权衡点

维护状况检查

讨论最多的未关闭 issue

兼容性

快速开始

使用场景

同类工具

评论

ha-mcp

功能特性

为什么选择它

权衡点

维护状况检查

讨论最多的未关闭 issue

兼容性

快速开始

使用场景

同类工具

评论