核心用法
mcp-hass 是一款基于 MCP（Model Context Protocol）协议的命令行工具，专用于与 Home Assistant 智能家居平台交互。用户可通过 mcporter CLI 实现对智能设备的开关控制、状态查询及精细化调节。
主要功能模块：
- 状态查询：
home-assistant.GetLiveContext获取全屋设备实时状态 - 设备开关：
HassTurnOn/HassTurnOff支持按名称、区域（area）或设备类型（domain）批量控制 - 灯光调节：
HassLightSet支持 0-100% 亮度调节及颜色设置 - 风扇控制：
HassFanSetSpeed支持 0-100% 风速档位调节
显著优点
1. 协议标准化：采用 MCP 开放协议，打破平台壁垒，可与 Claude 等 AI 助手深度集成
2. 灵活定位：支持多维度设备寻址（name/area/domain 组合），适配复杂家居拓扑
3. 零代码自动化：命令行即开即用，适合开发者快速构建脚本化场景
4. 本地优先：直接连接 Home Assistant 本地实例，响应延迟低
潜在缺点与局限性
- 配置门槛高：需手动配置
HASS_BASE_URL和HASS_ACCESS_TOKEN，对非技术用户不友好 - 依赖 Home Assistant：必须预先部署 HA 并完成 MCP 集成设置
- 工具链依赖：需安装 Node.js 及
mcporter工具链 - 功能覆盖面：目前仅支持灯、风扇等基础设备，复杂场景（如自动化规则编辑）未覆盖
适合人群
- 已部署 Home Assistant 的智能家居进阶用户
- 希望通过 AI 助手语音/文本控制家居的技术爱好者
- 需要批量操作设备的自动化脚本开发者
常规风险
- 令牌泄露：
HASS_ACCESS_TOKEN具备完整设备控制权，需妥善保管 - 网络暴露：若 HA 实例对外开放，需确保 HTTPS 及强认证机制
- 误操作风险：批量区域控制可能意外触发关键设备（如安防系统）