非官方Home Assistant MCP服务器

ha-mcp是一个基于模型上下文协议（MCP）的独立服务器，专为AI助手与Home Assistant智能家居平台深度交互而设计。通过自然语言指令，用户可以实现设备控制、状态查询、服务执行以及自动化管理等多种功能。该项目在GitHub上已获得超过3400颗星和137个分支，社区活跃且更新频繁。

安装方式灵活多样，覆盖macOS、Linux、Windows和Home Assistant OS等多个平台。macOS和Windows用户可通过简单的命令行脚本快速安装并连接至Claude Desktop；Linux用户可选择社区版Claude Desktop或官方Claude Code；Home Assistant OS用户则可通过官方插件一键安装。此外，还支持通过Nabu Casa或Webhook代理实现远程访问，无需额外隧道或端口转发。

ha-mcp提供多达84种工具，涵盖搜索与发现、设备控制、管理、监控、系统操作及安全六大类。具体包括模糊实体搜索、深度配置搜索、单设备及批量控制、自动化与脚本管理、仪表板编辑、区域与标签管理、历史记录与统计、摄像头快照、自动化追踪、ZHA设备管理、备份恢复、更新管理、插件操作等。安全功能方面，支持只读模式、按工具启用/禁用、用户审批策略及自动编辑备份。

与Home Assistant内置的MCP服务器相比，ha-mcp优势显著。内置服务器仅能控制已暴露给Assist的实体，而ha-mcp可访问Home Assistant中所有实体，并支持创建和编辑自动化、脚本、场景、仪表板，调试自动化，管理助手、区域、标签、分组，以及备份、插件、HACS和设备注册表。简言之，内置服务器适合语音控制场景，ha-mcp更适合需要AI助手参与构建和维护智能家居的用户。

此外，ha-mcp还提供可选的beta版自定义组件ha_mcp_tools，用于实现文件系统访问和YAML配置编辑等高级功能。该组件需通过HACS或手动安装，并需设置相应的环境变量（如HAMCP_ENABLE_FILESYSTEM_TOOLS=true）方能启用。安装后，用户可安全地编辑configuration.yaml文件、读写文件等。所有其他工具无需此组件即可正常工作。

总体而言，ha-mcp为Home Assistant用户带来了强大的AI集成能力，使智能家居的配置与管理变得更加直观和高效。无论是智能家居新手还是资深玩家，都能借助自然语言与AI助手协作，大幅提升自动化体验。