🏠 Home Assistant via MCP protocol

核心用法

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 作为第三方工具，更新维护持续性需关注

核心功能

mcp-hass 是一款通过 Model Context Protocol (MCP) 协议与 Home Assistant 智能家居系统交互的文档型 Skill。它允许用户通过自然语言指令控制灯光、风扇等设备，查询设备状态，实现 AI 助手与本地智能家居的无缝对接。

主要能力：

• 获取全屋设备实时状态 (home-assistant.GetLiveContext)
• 控制设备开关 (HassTurnOn/HassTurnOff)，支持按名称、区域、设备类型批量操作
• 调节灯光亮度 (HassLightSet, 0-100%) 和颜色
• 调节风扇风速 (HassFanSetSpeed, 0-100%)

显著优点

1. 官方协议支持：基于 Home Assistant 官方 MCP 集成，非第三方逆向方案，兼容性与稳定性有保障
2. 纯文档零风险：T-MD 纯 Markdown 类型，无可执行代码，无依赖注入风险
3. 灵活的设备寻址：支持「名称」「区域」「设备类型」多维度定位，如 "Bedroom Light" 或 area: "Bedroom", domain: ["light"]
4. 配置标准化：使用 HASS_ACCESS_TOKEN 和 HASS_BASE_URL 标准环境变量，符合安全最佳实践
5. 工具链成熟：依赖 mcporter（支持 npx 免安装运行），MCP 生态逐步完善

潜在局限与风险

| 维度 | 说明 |

|------|------|

| **网络依赖** | 需本地 Home Assistant 实例在线，无法离线控制 |

| **配置门槛** | 需手动启用 MCP Server、获取 Long-Lived Access Token，对新手有学习成本 |

| **权限管理** | Token 权限由 Home Assistant 侧控制，Skill 本身无法限制操作范围；需用户自行配置最小权限 |

| **传输安全** | 默认本地 HTTP (8123 端口)，需用户主动启用 HTTPS/SSL 才能加密传输 |

| **生态局限** | MCP 协议尚在早期普及阶段，部分复杂自动化场景可能无法覆盖 |

适合人群

• Home Assistant 现有用户：已自建 HA 系统，希望扩展 AI 语音/聊天控制入口
• 智能家居发烧友：追求本地化、隐私优先的智能家居方案，不愿依赖云服务
• 开发者/技术爱好者：愿意配置环境变量、理解 MCP 协议工作原理

常规风险

• 令牌泄露风险：HASS_ACCESS_TOKEN 为长期凭证，若硬编码或日志泄露可能导致未授权访问
• 本地网络暴露：若将 8123 端口映射至公网且无 HTTPS，存在中间人攻击风险
• 误操作风险：自然语言指令可能产生歧义，建议关键操作（如安防设备）二次确认

---

安全评分：A (85/100) — 无可执行代码，静态分析通过，外部资源均来自可信域名（GitHub、Home Assistant 官网），唯一需注意点为本地 HTTP 通信需配合 HTTPS 加固。