voska/hass-mcp

解决的问题

它允许 AI 助手（如 Claude）直接与 Home Assistant 实例交互。这使得用户能够使用自然语言而非手动配置来控制智能家居、查询设备状态、排查自动化问题并管理仪表盘。

工作原理

它实现了 Model Context Protocol (MCP) 服务器，作为 LLM 与 Home Assistant API 之间的桥梁。它提供了一组工具，LLM 可以调用这些工具来执行操作（如关闭灯光）、检索数据（如传感器历史记录或错误日志），并通过 WebSocket 编辑 Lovelace 仪表盘，并支持 stdio 和可流式传输的 HTTP 传输方式。

适用人群

希望将家庭自动化与高级 AI 代理集成以实现更轻松控制和引导式故障排除的智能家居爱好者和 Home Assistant 用户。

主要亮点

• 完整设备控制：查询状态、控制实体、调用任何 Home Assistant 服务。
• 仪表盘编辑：读取并实时编辑 Lovelace 仪表盘，支持自动备份和预览模式。
• 高级诊断功能：可访问 Home Assistant 错误日志和实体状态历史/统计数据。
• 引导式对话：内置提示，用于创建自动化、调试问题和优化流程。
• 高效使用 Token：使用轻量级 JSON 响应，最大限度减少 LLM 的 Token 消耗。
• 灵活部署：支持 Docker、uv/uvx 和 HTTP 传输，适用于网络化工具。