项目截图
概览
ha-mcp 是一个使用 FastMCP 构建的非官方 MCP 服务器，用于在 AI 助手和 Home Assistant 之间建立桥梁。与 Home Assistant 内置的、专注于语音式控制已暴露实体的 MCP 服务器不同，ha-mcp 提供了用于配置、构建和维护智能家居的工具。它允许 AI 客户端创建和编辑自动化、脚本、仪表板以及管理系统设置。该服务器跨设备控制、系统监控、文件管理和 YAML 编辑等类别公开了 88 个工具，可通过自定义组件在进程内运行，或作为附加组件、通过 Docker 或本地通过 stdio 运行。
主要功能
- 88 个用于 Home Assistant 交互的工具
- 通过 HACS 自定义组件实现进程内服务器，具备完整功能对等性
- 创建、编辑和调试自动化、脚本及仪表板
- 只读模式切换和按工具启用/禁用功能
- 自动编辑备份和工具安全策略
- 将捆绑的 Agent Skills 作为 MCP 资源提供
- 用于远程访问的可选 OIDC 身份验证
- 用于 YAML 和文件系统编辑的 Beta 工具
要求、安装和快速入门
推荐的方法是通过 HACS 安装 HA-MCP 自定义组件：在 HACS 中添加 `https://github.com/homeassistant-ai/ha-mcp-integration` 仓库，下载，重启 Home Assistant，然后添加“HA-MCP Server”集成。或者，从商店安装 Home Assistant App/附加组件，或使用 `ghcr.io/homeassistant-ai/ha-mcp` 通过 Docker 运行，或使用 `uvx ha-mcp@latest` 通过 PyPI 运行。手动安装涉及将 `custom_components/ha_mcp_tools/` 复制到 HA 配置目录中。
用法
安装后，从集成的配置屏幕或附加组件日志中复制连接 URL。将此 URL 粘贴到您的 AI 客户端的 MCP 配置中。然后，您可以使用自然语言与 Home Assistant 进行交互，要求 AI 创建自动化、检查状态或管理仪表板。
模型兼容性与使用场景
Not stated in the repository metadata
许可证与风险说明
仓库元数据显示许可证为 MIT。发布或商用前，请核对仓库中的 LICENSE 文件、版权声明及依赖项许可条款。
Editorial verification 2026-08-09: repository URL, owner, description, license and repository statistics were reviewed. License metadata: MIT. README was fetched for the channel draft; re-check repository dependencies, releases and model terms before production use.
发布与维护
v7.3.0 中的破坏性变更：`ha_config_set_yaml` 移至 Beta。