HA-MCP 家庭自动化工具控制台

面向 Home Assistant 的 MCP 自动化工具与中文配置控制台，帮助 AI 助手安全地查询设备、管理自动化规则并维护服务设置。

本交付基于固定源码版本，包含 ha-mcp Python 服务、stdio sidecar 设置页和 Astro 使用文档。运行实例提供工具目录、搜索过滤、服务设置、自动备份配置与工具安全策略页面；工具状态支持启用、停用和固定，写入类能力可结合安全门控与备份流程使用。

真实界面

项目截图

共 6 张

Capabilities

核心功能

✓通过 MCP 工具查询 Home Assistant 设备状态、区域、服务和系统信息

✓按家庭自动化、设备控制、备份恢复等分组浏览工具目录

✓在中文网页控制台中搜索、启用、停用和固定工具

✓集中管理工具搜索、超时、重试和其他高级运行设置

✓提供自动备份开关、间隔、保留数量和备份目录配置

✓支持逐工具安全门控、审批有效期与策略规则配置

适用场景

让 AI 助手先查询设备状态，再按授权范围执行灯光、空调和自动化操作

为智能家居集成项目筛选需要暴露给 MCP 客户端的工具集合

在修改自动化、脚本或场景前配置备份与安全策略，降低误操作风险

适合谁

使用 Home Assistant 的个人用户、智能家居集成服务商、自动化爱好者，以及需要把 AI 助手接入家庭设备控制流程的小团队。

商业化思路

适合作为 Home Assistant AI 自动化集成的开源基础，进一步提供安装部署、设备接入、自动化规则设计、安全策略配置和持续运维服务；商业再分发前应遵守上游许可证并披露中文本地化修改。

你会拿到什么

✓ha-mcp Python 源码、MCP 工具实现、设置 UI 与 stdio sidecar
✓Astro 中文使用文档、安装配置文件和测试套件
✓上游 LICENSE、来源信息、中文修改披露和本地运行说明

部署流程

1安装 Python 3.13 与 Home Assistant，准备 Home Assistant URL 和长期访问令牌
2在源码目录创建 Python 3.13 虚拟环境并安装项目依赖，按需执行 pytest 验证
3stdio 模式交给支持 MCP 的客户端启动；Web/Docker 模式按项目文档配置 transport、认证和端口
4首次运行后打开设置页，检查工具目录、备份目录和安全策略，再按最小权限启用需要的工具

真实验证结果

已按固定 commit 与源码 SHA 完成本地 Python 3.13 环境安装、定向单元回归、Astro 站点构建、sidecar HTTP/API 联调、工具设置写入、功能开关写入、安全策略读写、6 个 1440x900 浏览器状态截图及截图哈希绑定；生产发布前仍需通过工厂预发布门禁。

部署前须知

stdio sidecar 与主 MCP 进程分离，因此实时审批队列仅在主服务进程可用；本地无 Home Assistant 实例时只能验证设置页和本地配置，无法验证真实设备读写。生产部署前应自行配置密钥、网络访问控制、备份存储和日志策略。

部署难度

中等

最低配置

需要 Python 3.13（项目约束为 >=3.13,<3.14）、Home Assistant 实例及长期访问令牌；stdio 模式由 MCP 客户端启动，Web/Docker 模式还需要配置监听地址、认证和反向代理。

开源许可证

MIT License

最后验证

2026-09-02

技术栈

Python 3.13FastMCPStarlette/UvicornPydanticHome Assistant REST/WebSocket APIAstro 与 Tailwind CSS

授权说明

上游仓库包含 LICENSE 文件，交付包保留该文件及原作者声明；本次增加中文设置页文案并补齐 stdio sidecar 的高级设置、备份与策略相关路由，未主张上游源码权利。再分发时请保留许可证、版权、来源链接和修改披露。

Release notes

版本记录

1 个已发布版本

vcn-1c595947da0b 当前推荐

2026-09-02

完成候选 444 固定源码版本的中文设置控制台本地化，并补齐 stdio sidecar 的高级设置、备份和安全策略路由；通过本地 API、构建、回归与浏览器验收。

部署要求：Python 3.13、Home Assistant 实例、长期访问令牌；stdio 模式需要支持 MCP 的客户端。

已知问题：本次本地验证未连接真实 Home Assistant；sidecar 的实时审批依赖主 MCP 进程，生产环境请结合主服务日志与安全策略回读。

登录后领取