FeyaGate 智能家居网关

要解决的问题

智能家居设备往往分散在多个平台上。小米生态的摄像头、小爱音箱，涂鸦和 Smart Life 生态的开关插座，美的的空调，eWeLink 的 Sonoff 设备——它们各自使用不同的本地协议、云接口和控制模型。当 AI agent 需要一次性查看所有设备并执行联动操作时，就得为每个平台维护一套适配代码，调试成本很高。

核心能力与工作流程

FeyaGate 作为 MCP 网关，把不同平台的设备统一成一套跨平台工具。它的核心思路是：先发现设备，再识别平台，最后按需加载对应平台的子技能。

典型的调用链路如下：

1. 调用 device/list 获取当前网关下已连接的设备列表，每条记录带 platform 字段标识所属平台。
2. 对目标设备调用 device/specs，拿到该设备在对应平台上的属性和动作清单（properties、actions）。
3. 根据 platform 字段决定是否加载子技能，例如 feyagate-xiaomi、feyagate-tuya、feyagate-midea 或 feyagate-ewelink。
4. 执行具体的控制调用，比如开灯、触发场景、读取传感器数据。

这种按需加载子技能的策略意味着主技能只保留跨平台的通用工具，平台相关的细节被拆分到独立文档中，避免单次加载过多无关指令。

服务器生命周期也由一组命令管理：feyagate setup 安装二进制、feyagate start 启动服务、feyagate stop 停止、feyagate status 查看状态、feyagate log 读取日志。每次调用任何 MCP 工具前，agent 应先通过 gateway/info 或 platform/status 确认服务处于 RUNNING 状态。

适用边界与注意点

许可证是第一个需要留意的点。 免费版仅包含小米平台的全部能力——设备控制、摄像头、小爱音箱以及 MCP 代理。涂鸦、美的和 eWeLink 平台的控制能力属于商业授权范围。在免费版中，tuya/set_property、midea/set_property、ewelink/set_property 这类写入操作会返回 license_required，但对应的 get_properties 等读取工具仍可正常工作。

参数命名存在两套约定。 跨平台工具 device/specs 使用 deviceId（camelCase），而平台专属工具如 xiaomi/*、tuya/* 使用 device_id（snake_case）。调用时需要注意区分，混用会导致找不到设备或参数校验失败。

平台连接状态需要主动检查。 即使设备出现在 device/list 中，也不代表平台侧的授权和同步已完成。platform/status 工具会返回每个平台的连接、认证和同步状态，建议在首次操作前确认。

子技能需要手动加载。 主技能不会自动注入平台专属指令。如果 agent 直接尝试调用 tuya/set_property 而没有加载 feyagate-tuya 子技能，会收到工具不存在的错误。正确的顺序是先 device/list 确认平台，再按需加载对应子技能文档。

配置和日志路径是固定的。 配置文件位于 ~/.feyagate/config/config.yaml，日志通过 feyagate log -n 50 查看。遇到 connection refused 通常意味着服务未启动，authorized: false 则需要运行 feyagate auth 或对应的平台认证工具。