BAIZE AI RESOURCE

智能家居控制MCP服务

Ha-mcp

Ha-mcp 是连接 AI 助手与 Home Assistant 的 MCP 服务，让用户通过自然语言查询设备状态、控制智能家居，并管理自动化。它减少了在不同设备和设置页面之间反复切换的操作。

获取资源
Ha-mcp

资源介绍

Ha-mcp 面向已使用 Home Assistant、希望让 AI 助手参与智能家居管理的用户。它将 Home Assistant 的设备控制、状态查询、实体搜索和自动化管理等操作提供给 MCP 客户端。连接后，用户可以用自然语言询问设备状态，或提出控制设备、管理自动化的需求。项目推荐通过 HACS 安装 HA-MCP Custom Component：在 Home Assistant 中启用集成后，将配置页提供的连接 URL 填入 AI 客户端即可使用。这种方式适用于 Home Assistant OS、Supervised、Container 和 Core。它也提供 Home Assistant 附加组件等运行方式；选择一种安装方式即可，不应同时运行多个服务实例。

软件界面、操作截图与实际案例预览。

Ha-mcp 展示图 1

MCP 能力

设备状态与控制

让 AI 助手查询 Home Assistant 中的设备状态，并调用设备控制操作。

自动化管理

通过 MCP 工具管理 Home Assistant 自动化，减少在设置页面中查找操作入口的步骤。

实体模糊搜索

查找 Home Assistant 实体时支持模糊搜索，名称输入有误也能辅助定位。

日历与待办操作

向 AI 助手提供 Home Assistant 日历和待办列表的相关工具。

配置备份与恢复

提供备份和恢复能力，供用户管理 Home Assistant 配置变更。

资源配置

支持客户端

Claude DesktopChatGPT其他 MCP Client

安装方式

手动安装uvDocker其他

配置方式

GUI环境变量

运行环境

Docker其他

安装与配置

  1. 阅读资源包中的中文说明和上游官方文档。

  2. 核对版本、运行环境与依赖条件后完成配置。

  3. 先在隔离环境验证主要功能，再用于实际场景。

使用案例

查询家中设备状态

使用场景Home Assistant 用户想知道设备当前状态

将 ha-mcp 连接到 AI 客户端后，用自然语言询问设备状态，由助手通过 Home Assistant 获取信息。

查找并控制设备

使用场景用户记不清设备在 Home Assistant 中的准确名称

向助手描述要操作的设备，借助实体模糊搜索定位对象，再通过设备控制工具执行操作。

包含内容

ha-mcp-source.zip
README-中文安装说明.md
LICENSE-MIT.txt
THIRD-PARTY-NOTICES.md
SHA256.txt

常见问题

HA-MCP Custom Component 支持哪些 Home Assistant 安装类型？
项目说明其推荐的集成安装方式适用于 Home Assistant OS、Supervised、Container 和 Core。
通过 HACS 安装后，如何取得 AI 客户端使用的连接地址？
重启 Home Assistant 并添加 HA-MCP Server 集成后，在该集成的“配置”页面复制连接 URL，填入 AI 客户端。
只想在本地网络使用，可以关闭远程访问吗？
可以。在集成选项中关闭“Remote access via webhook”后，不会注册远程访问 webhook；本地直连端口和侧边栏面板仍可使用。
可以同时运行集成内置服务和附加组件吗？
不建议。项目说明集成内置服务可替代附加组件、Docker 和 uvx/PyPI 等安装方式，应只运行其中一种。