homeassistant-ai/ha-mcp

解决的问题

它允许 AI 助理（如 Claude 或 ChatGPT）直接与 Home Assistant 智能家居系统交互。用户无需手动配置设备和自动化，即可通过自然语言控制家庭设备、查询设备状态并管理底层系统配置。

运作方式

该项目实现了一个模型上下文协议 (MCP) 服务器。该服务器充当 AI 客户端与 Home Assistant API 之间的桥梁，提供了一套全面的工具（共 87 个），AI 可以调用这些工具来执行服务、读取实体状态、编辑 YAML 配置以及管理仪表板。

适用对象

希望将 AI 助理集成到其智能家居生态系统中，以实现更轻松的控制和配置的智能家居爱好者和 Home Assistant 用户。

特色亮点

• 丰富的工具集：提供 87 种工具，涵盖搜索、设备控制、自动化管理和系统管理。
• 多种部署选项：可作为 Home Assistant 自定义组件 (通过 HACS)、Home Assistant 应用/插件、Docker 容器或独立的 Python 包安装。
• 自然语言配置：支持 AI 使用纯文本指令创建自动化、脚本和仪表板卡片。
• 安全功能：包含“只读模式”切换、特定工具的启用/禁用设置，以及自动编辑备份。
• 远程访问：支持多种远程连接方式，包括 Nabu Casa、webhooks 和 OIDC 认证。