homeassistant-ai/ha-mcp

The Unofficial and Awesome Home Assistant MCP Server

解决的问题

AI 助手通常对智能家居设备的访问权限有限。本项目提供了一个全面的 Model Context Protocol (MCP) 服务器，允许 LLM 超越简单的设备控制，能够使用自然语言实际管理、配置和调试 Home Assistant 实例。

工作原理

该服务器充当 MCP 兼容的 AI 客户端（如 Claude Desktop、ChatGPT 或 Cursor）与 Home Assistant 安装实例之间的桥梁。它提供了 85 多个专业工具，允许 AI 与系统进行交互。可以通过 Home Assistant 自定义组件、加载项 (add-on)、Docker 或通过 PyPI 进行安装。

适用对象

  • 智能家居爱好者：希望使用 AI 创建自动化、脚本和场景的用户。
  • 高级用户：希望使用执行追踪和日志来调试自动化流程的用户。
  • 开发者：希望通过自然语言使用 AI 构建和编辑仪表板、管理辅助工具或配置系统设置的用户。

亮点

  • 深度配置：使 AI 能够创建/编辑自动化、脚本、场景和仪表板。
  • 系统管理：允许管理加载项、备份、HACS 和设备注册表。
  • 高级调试：提供访问自动化追踪、日志和历史记录的权限，用于故障排除。
  • 广泛的兼容性：支持多种安装方法，包括进程内自定义组件和 Docker。
  • 安全功能：包括只读模式、逐工具启用/禁用选项以及用户批准策略。