一句话掌控全屋智能设备

基于 MCP 协议连接 Home Assistant 智能家居平台，实现灯光、风扇等设备语音控制与状态查询，依托成熟开源生态提供便捷家居自动化体验。

基本信息

• 技能名称?mcp-hass
• 中文名称?一句话掌控全屋智能设备
• 作者?al-one
• 分类?效率
• 版本?v1.0.1
• 标签?automation, api, iot, smart-home, productivity

使用方法

使用说明
核心用法
mcp-hass 是一个通过 Model Context Protocol (MCP) 协议与 Home Assistant 智能家居系统交互的 Skill。用户需先在 Home Assistant 中启用 MCP 服务器集成，配置 HASS_BASE_URL 和 HASS_ACCESS_TOKEN 环境变量后，即可通过 mcporter CLI 工具执行设备控制命令。核心功能包括：查询设备实时状态（ GetLiveContext ）、开关设备（ HassTurnOn/HassTurnOff ）、调节灯光亮度与颜色（ HassLightSet ）、控制风扇转速（ HassFanSetSpeed ）等。支持按设备名称、区域（area）、设备类型（domain）等多维度定位目标设备，命令语法简洁直观。
显著优点

1. 协议标准化 ：采用 Anthropic 推出的 MCP 开放协议，具备良好的互操作性和未来扩展性。
2. 生态成熟 ：Home Assistant 是全球最活跃的开源智能家居平台，支持数千种设备品牌，生态丰富度无可比拟。
3. 部署灵活 ：通过环境变量配置即可连接本地或远程 Home Assistant 实例，支持 HTTP/HTTPS 多种传输方式。
4. 无代码侵入 ：Skill 本身仅为配置层，不嵌入业务逻辑，安全边界清晰，便于审计和维护。
5. 社区活跃 ：依赖的 mcporter 工具和 Home Assistant 均有活跃社区，问题响应和更新迭代有保障。
   潜在缺点与局限性
6. 外部依赖重 ：核心功能完全依赖 npm 包 mcporter ，若该包停止维护或出现安全漏洞，将直接影响 Skill 可用性。
7. 网络依赖强 ：所有操作需实时连接 Home Assistant 服务器，离线环境或网络波动时无法使用。
8. 配置门槛 ：需用户自行获取访问令牌、配置环境变量，对非技术用户存在一定上手难度。
9. 功能受限 ：仅封装了部分常用设备控制接口，复杂自动化场景（如条件判断、定时任务）仍需在 Home Assistant 原生界面配置。
10. 无本地缓存 ：每次查询均实时调用 API，高频操作可能增加服务器负载。
    适合的目标群体
    智能家居爱好者 ：已部署 Home Assistant 且希望扩展语音/AI 控制入口的用户。
    技术型家庭用户 ：具备基础 Linux/命令行操作能力，愿意配置环境变量的进阶用户。
    开发者与集成商 ：需要将 Home Assistant 能力嵌入自有 AI Agent 或自动化工作流的工程团队。
    多设备管理场景 ：拥有跨品牌、跨协议智能设备，希望通过统一接口集中控制的场景。
    使用风险
11. 凭证安全 ： HASS_ACCESS_TOKEN 以环境变量形式传递，可能被同一主机的其他进程读取，建议配合最小权限令牌使用。
12. 供应链风险 ： mcporter 为个人开发者维护的 npm 包，虽开源可查，但缺乏企业级安全审计背书。
13. 网络暴露风险 ：若通过公网访问 Home Assistant，需确保 HTTPS 加密和访问控制，防止令牌截获。
14. 命令注入隐患 ：用户输入的设备名称等参数直接拼接至命令行，虽 mcporter 内部应有转义，但仍建议避免特殊字符。
15. 服务可用性 ：Home Assistant 或 mcporter 任一服务异常均会导致 Skill 失效，建议部署监控告警。