# 一行命令让 AI 接管全屋智能:FeyaGate Skill 保姆级接入教程,小米/涂鸦/美的/易微联全搞定
在 AI Agent 生态爆发式生长的 2025 年,如何让 OpenClaw、Hermes 或 Claude Code 直接控制物理世界的智能设备,成了高阶开发者的“最后一道坎”。本文带你零基础部署 FeyaGate Skill——一个基于 MCP 协议的智能家居统一网关,一行命令安装,十分钟完成米家授权,让你的 AI 通过 MCP轻松操控小米、涂鸦、美的、易微联四大平台设备,并实现摄像头 P2
一行命令让 AI 接管全屋智能:FeyaGate Skill 保姆级接入教程,小米/涂鸦/美的/易微联全搞定
摘要:在 AI Agent 生态爆发式生长的 2025 年,如何让 OpenClaw、Hermes 或 Claude Code 直接控制物理世界的智能设备,成了高阶开发者的“最后一道坎”。本文带你零基础部署 FeyaGate Skill——一个基于 MCP 协议的智能家居统一网关,一行命令安装,十分钟完成米家授权,让你的 AI 通过 JSON-RPC 2.0 轻松操控小米、涂鸦、美的、易微联四大平台设备,并实现摄像头 P2P 抓拍、AI 视觉分析、小爱 TTS 播报、触发自动化等进阶玩法。全文附详细代码示例,免费版即可覆盖 70% 家用场景。
目录
- 为什么 AI Agent 控制智能家居这么难
- FeyaGate Skill 是什么
- 技术架构与 MCP 工具清单
- 安装与启动:真·一行命令
- 平台授权配置(小米/涂鸦/美的/易微联)
- 实战一:用 AI 说人话控灯
- 实战二:摄像头 P2P 抓拍 + AI 安全分析
- 实战三:小爱音箱当 AI 的嘴替
- 实战四:触发引擎实现主动式自动化
- 技术亮点解析
- 许可证说明与免费版权益
- 总结与入门资源
一、为什么 AI Agent 控制智能家居这么难
如果你正用 OpenClaw、Claude Code 或 Hermes 构建 Agent,大概率遇到过这个瓶颈:Agent 能写代码、能做推理,却打不开客厅的灯。
智能家居领域碎片化持续多年:小米用 MIOT 私有协议,涂鸦开发者平台版本割裂,美的依靠封闭云服务,易微联走 CoolKit……想让 Agent 调用设备?你得分别阅读四套 SDK 文档,为每个平台写适配层,再处理认证、轮询和异常。
这就是物理世界与 AI 之间的“协议鸿沟”。
FeyaGate Skill 用 MCP 标准把这道鸿沟填平了。
二、FeyaGate Skill 是什么
FeyaGate Skill 是一款运行在 桌面端(macOS / Linux / Windows)的智能家居 MCP 网关,原生支持 MCP(Model Context Protocol),通过 HTTP + JSON-RPC 2.0 协议为 AI Agent 暴露统一的多平台设备控制工具。
一句话:
一次部署,让 Agent 像调本地 API 一样操控小米、涂鸦、美的、易微联全屋设备。
核心特征:
- 🧩 多平台统一抽象:底层适配四套完全不同 SDK,上层统一为 23+ 个 MCP 工具
- 📹 摄像头 P2P 直连:不经过厂商云,延迟 < 500 ms,返回 base64 JPEG
- 🤖 AI 视觉分析管道:定时抓拍 + 多模态模型推理,直接输出结构化结果
- 🔊 小爱音箱全控制:TTS 播报、静默语音控制设备
- ⏰ 自动化引擎:Cron 定时任务 + 摄像头条件触发规则
- 🆓 免费版白嫖小米全家桶:覆盖国内 70% 以上智能设备
三、技术架构与 MCP 工具清单
3.1 架构总览
AI Agent (Claude Code / OpenClaw / 自定义客户端)
│
│ MCP over HTTP (JSON-RPC 2.0)
▼
miloco-mcp-server (桌面端 MCP 服务)
localhost:38080/mcp/http
│
┌────┼────┬────┬────┐
▼ ▼ ▼ ▼
Xiaomi Tuya Midea eWeLink
MCP Server 内部使用策略模式封装 IDeviceProvider,对上层 Agent 完全透明。
3.2 核心 MCP 工具一览
跨平台基础工具(4 个):
| 工具名 | 功能 |
|---|---|
device/list |
按平台、房间、类型筛选设备 |
device/specs |
获取指定设备属性定义(siid/piid) |
auth/platforms |
查看各平台授权状态 |
gateway/info |
网关版本、许可证信息 |
小米平台(16 个工具):
涵盖 OAuth 授权、MIOT 属性读写、摄像头 P2P 连接与抓拍、小爱 TTS/控制……
涂鸦 / 美的 / 易微联(各 4 个):
授权、设备刷新、属性读写统一封装。
自动化引擎(12 个工具):
Cron 定时任务、摄像头触发规则管理。
系统工具:
许可证管理、视觉 AI 配置、统计面板。
所有这些工具都通过统一的 JSON-RPC 2.0 接口暴露,只需在 MCP 客户端配置 URL 即可使用。
四、安装与启动:真·一行命令
4.1 一键在线安装
macOS / Linux:
curl -fsSL https://www.feyagate.com/install.sh | bash
Windows PowerShell:
iwr -useb https://www.feyagate.com/install.ps1 | iex
脚本会自动完成:
- 从 OTA 服务获取最新版本信息
- 克隆
feyagate-skill仓库(含脚本与配置模板) - 下载对应平台二进制包并校验 MD5
- 解压至
bin/、lib/、webui/ - 生成默认配置文件
指定安装路径:
curl ... | bash -s -- --dir ~/my-skill
4.2 启动服务
cd feyagate-skill
bash scripts/start.sh
bash scripts/health_check.sh # 输出 "OK" 即启动成功
服务默认监听 http://localhost:38080/mcp/http,可通过 --port 指定其他端口。
五、平台授权配置
5.1 米家账号授权(必须)
python3 scripts/auth.py
- 控制台输出 OAuth 授权链接
- 浏览器打开链接,登录小米账号
- 登录成功后跳转至
https://127.0.0.1/?code=xxxxxx - 复制完整 URL 粘贴回终端,回车完成
验证授权:
调用 xiaomi/auth_status,返回 authorized: true 即成功。
5.2 涂鸦平台(扫码授权)
通过 MCP 工具获取二维码:
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "auth/tuya_qr",
"arguments": {}
}
}
用涂鸦智能 App 扫码,再轮询 auth/tuya_qr_status 确认授权。
5.3 美的 / 易微联
使用 auth/midea_login 或 auth/ewelink_login,传入账号密码即可完成绑定。
六、实战一:用 AI 说人话控灯
搭配 Claude Code 等 MCP 客户端,只需自然语言指令:
“打开客厅的灯,调成暖色,亮度 50%”
Agent 内部自动执行序列:
- 调用
device/list获取设备列表并筛选“客厅灯” - 调用
device/specs获取亮度(siid=2, piid=2)和色温(siid=2, piid=3)属性定义 - 调用
set_xiaomi_device_property设置电源(siid=2, piid=1, value=true) - 调用
set_xiaomi_device_property调整亮度和色温
全程无需手动查询 did、siid、piid,Agent 自动适配。
七、实战二:摄像头 P2P 抓拍 + AI 安全分析
7.1 连接摄像头
curl -X POST http://localhost:38080/mcp/http \
-H "Content-Type: application/json" \
-d '{
"jsonrpc":"2.0",
"id":1,
"method":"tools/call",
"params":{
"name":"xiaomi/camera_connect",
"arguments":{
"camera_id":"YOUR_CAMERA_DID"
}
}
}'
P2P 穿透需等待 3~5 秒,完成后抓拍:
curl -X POST http://localhost:38080/mcp/http \
-H "Content-Type: application/json" \
-d '{
"jsonrpc":"2.0",
"id":2,
"method":"tools/call",
"params":{
"name":"xiaomi/camera_snapshot",
"arguments":{
"camera_id":"YOUR_CAMERA_DID",
"count":1
}
}
}'
返回 JSON 中包含 base64 字段,可直接传给 GPT-4V、Claude 等多模态模型。
7.2 定时 AI 巡检
内置脚本实现自动化管道:
python3 scripts/scheduled_analysis.py \
--camera-id YOUR_CAMERA_DID \
--interval 300 \
--auto-connect \
--prompt "Describe the scene. Flag any security concerns."
每 300 秒抓拍 → 调用多模态推理 → 输出结构化告警。可作为家庭安防的核心组件。
八、实战三:小爱音箱当 AI 的嘴替
TTS 语音播报
{
"jsonrpc":"2.0",
"id":3,
"method":"tools/call",
"params":{
"name":"xiaoai/tts",
"arguments":{
"device_id":"SPEAKER_DID",
"text":"欢迎回家,已为您打开客厅灯和空调"
}
}
}
静默控制(音箱不发声)
{
"jsonrpc":"2.0",
"id":4,
"method":"tools/call",
"params":{
"name":"xiaoai/control",
"arguments":{
"device_id":"SPEAKER_DID",
"command":"打开客厅灯",
"silence":true
}
}
}
结合 Agent 的场景感知,可实现回家自动播报 + 静默执行全屋场景。
九、实战四:触发引擎实现主动式自动化
通过 trigger/create 工具定义规则,示例:摄像头检测到人 → 开灯 + TTS。
{
"name": "客厅有人检测",
"cameras": ["CAMERA_DID"],
"condition": "vision_ai_detects_person",
"actions": [
{
"tool": "set_xiaomi_device_property",
"args": {
"deviceId": "LAMP_DID",
"siid": 2,
"piid": 1,
"value": true
}
},
{
"tool": "xiaoai/tts",
"args": {
"device_id": "SPEAKER_DID",
"text": "客厅有人"
}
}
]
}
触发引擎支持多个摄像头与条件组合,完全可编程。
十、技术亮点解析
-
MCP 原生,即插即用
Anthropic 发布的 Model Context Protocol 已成为 AI 工具调用的事实标准。FeyaGate Skill 直接实现了 MCP 服务端,Claude Code、OpenClaw 配置 URL 后立即获得设备控制能力,无需额外 SDK。 -
跨平台统一抽象
基于IDeviceProvider策略模式,将小米 MIOT、涂鸦 OpenAPI、美的云、易微联 CoolKit 全部封装为同一套工具集。上层 Agent 完全无需感知平台差异。 -
摄像头 P2P 直连
采用 P2P 协议穿透,不经过小米云端服务器,既保护隐私又降低延迟(< 500ms),返回 base64 编码可直接入模推理。 -
全平台二进制交付
macOS (Intel/Apple Silicon)、Linux x86_64、Windows x64 均提供原生二进制,无需依赖 Docker 或 Python 环境。
十一、许可证说明与免费版权益
| 版本 | 支持平台 | 核心功能 |
|---|---|---|
| 免费版 | 小米全生态 | 设备控制、摄像头 P2P、小爱音箱、MCP 代理、自动化引擎 |
| 付费版 | 小米 + 涂鸦 + 美的 + 易微联 | 全部工具 |
免费版已包含自动化规则、定时任务、视觉分析等进阶能力,足以覆盖绝大多数以米家为中心的智能家居场景。
十二、总结与入门资源
FeyaGate Skill 解决了 AI Agent 进入物理世界的“最后一公里”问题:用 MCP 统一了碎片化的智能家居协议,让开发者只需关注业务逻辑,而非平台适配。
快速开始
# 安装
curl -fsSL https://www.feyagate.com/install.sh | bash
# 启动
cd feyagate-skill
bash scripts/start.sh
# 米家授权
python3 scripts/auth.py
相关链接
- 官网:https://www.feyagate.com
- 开源仓库(Gitee):https://gitee.com/panzuji/feyagate-skill
如果本文帮你节省了对接四大平台的时间,欢迎点赞、收藏、关注三连。评论区留下你的智能家居场景,我会挑选高赞需求输出更多实战教程。@TOC
更多推荐




所有评论(0)