核心用法
mcp-hass 是基于 Model Context Protocol (MCP) 协议的 Home Assistant 智能家居控制技能，通过 mcporter 命令行工具实现与 Home Assistant 实例的通信。用户需先在 Home Assistant 中启用 MCP 服务器集成，然后配置 HASS_BASE_URL 和 HASS_ACCESS_TOKEN 环境变量完成认证。
主要功能包括：
- 状态查询：
mcporter call home-assistant.GetLiveContext获取所有设备实时状态 - 设备控制：支持按名称、区域、域名精准定位设备执行开关操作
- 精细化调节：灯光亮度(0-100%)、风扇转速百分比控制
- 灵活寻址：支持组合条件（名称+区域+域名）定位目标设备
显著优点
1. 协议标准化：采用 MCP 开放协议，具有良好的生态兼容性和扩展性
2. 定位精准：支持多维度设备筛选（name/area/domain），避免误操作
3. 部署便捷：通过 npm 安装 mcporter，配置简单，支持 npx 零安装运行
4. 功能完备：覆盖灯光、风扇等常见智能家居场景的基础控制需求
潜在缺点与局限性
- 依赖外部集成：必须在 Home Assistant 服务端预先安装 MCP 集成，增加部署复杂度
- 令牌管理负担：需要长期有效的访问令牌，存在泄露风险
- 网络可达性要求：要求客户端能直接访问 Home Assistant 实例的 HTTP 接口
- 功能边界有限：仅支持基础开关和数值调节，不支持复杂自动化场景编排
- 调试门槛：命令行交互方式对用户的技术背景有一定要求
适合人群
- 已有 Home Assistant 部署的智能家居进阶用户
- 希望通过脚本/自动化工具批量控制设备的开发者
- 熟悉命令行操作、愿意配置环境变量的技术爱好者
- 需要将智能家居控制集成到 MCP 生态工作流中的用户
常规风险
- 令牌泄露风险：
HASS_ACCESS_TOKEN若被窃取，攻击者可远程控制家庭设备 - 网络暴露风险：HTTP 通信若未启用 TLS，存在中间人攻击隐患
- 误操作风险：命令行操作缺乏图形确认，可能意外触发设备状态变更
- 依赖维护风险：mcporter 作为第三方工具，更新维护持续性需关注