HA-MCP

项目简介

HA-MCP 是面向 Home Assistant 的独立 MCP（模型上下文协议）服务器，用于配置、构建和调试智能家居，而不仅是控制设备。它可与 Claude、ChatGPT、Cursor、Copilot 以及 15 个以上 AI 客户端配合使用，并提供覆盖搜索、控制、管理、监控、系统与安全类别的 87 个工具。

核心功能

• 87 个工具覆盖搜索、控制、管理、监控、系统与安全类别。支持自然语言设备控制、服务调用、批量操作和实时状态跟踪。可管理自动化、脚本、辅助实体、仪表板、区域、分区、分组、日历和蓝图。可通过历史、统计、摄像头快照、自动化跟踪和 ZHA 设备进行监控。系统能力包括备份与恢复、更新、应用、设备注册表和 HACS 管理。安全功能包括只读模式、逐工具启用或禁用、工具安全策略和自动编辑备份。

适用场景

• 创建在日落时打开门廊灯的自动化。向 Lovelace 仪表板添加天气卡片。通过分析执行跟踪来调试运动传感器自动化，并给出修复建议。创建可复用的电影模式脚本，调暗灯光、关闭百叶窗并打开电视。

快速开始

• 通过 HACS 安装 HA-MCP 集成，或在 Home Assistant 2026.11 及更高版本中通过“设置 → Marketplace”安装。重启 Home Assistant。选择服务器使用的管理员账户：可使用长期访问令牌，或创建一个仅限本地访问的专用管理员账户。添加 HA-MCP Server 集成，并选择通过 Home Assistant 的远程访问和/或本地网络访问。在“配置”屏幕复制连接 URL，并粘贴到 AI 客户端。

部署与要求

• HA-MCP 集成要求 Home Assistant 2026.8.0 或更高版本。进程内服务器可在 Home Assistant OS、Supervised、Container 和 Core 上运行，并保持完整功能一致。应用（加载项）适用于 Home Assistant OS 和 Supervised 安装。Docker、PyPI/uvx 和本地 stdio 在 Home Assistant 之外运行服务器，适用于 Container 或 Core 安装或单独主机。设置需要管理员访问令牌或专用管理员账户。

采用前须知

• 许可证：MIT。在使用、修改或分发项目前，请确认其具体条款。