feyagate-skill 1.2.2

MCP Smart Home Gateway for AI Agents - Control Xiaomi, Tuya, Midea, eWeLink devices via MCP protocol

FeyaGate Skill — MCP Smart Home Gateway for AI Agents

中文 | English

MCP Server | Smart Home | IoT Gateway | AI Agent Skill

---

FeyaGate (飞阳网关) is an MCP (Model Context Protocol) smart home gateway skill that enables AI agents — OpenClaw, Claude Code, Hermes, Codex, Windsurf, Copilot, 小智AI and other AI coding assistants — to directly control smart home devices through a unified MCP interface.

Based on miloco-mcp-server, it provides cross-platform device control for Xiaomi/Mi Home, Tuya, Midea, eWeLink, camera monitoring with P2P streaming, Xiao AI speaker control, scheduled automation, and persistent memory — all accessible as MCP tools for any compatible AI agent.

Website: www.feyagate.com

Supported AI Agents

AI Agent	Status	Integration
OpenClaw	Supported	MCP Skill auto-install
Claude Code	Supported	MCP config auto-setup
Hermes	Supported	MCP Skill auto-install
Codex	Supported	MCP Skill auto-install
Windsurf	Supported	MCP config auto-setup
Copilot	Supported	MCP config auto-setup
小智AI (Xiaozhi AI)	Supported	MCP Skill auto-install
Cursor	Supported	MCP config auto-setup

Project Structure

feyagate-skill/
├── SKILL.md                    # AI Agent Skill definition (MCP tool descriptions)
├── README.md                   # Project README (this file)
├── QUICKSTART.md               # Quick start guide
├── reference.md                # Full MCP API reference
│
├── config/                     # Config templates (version-controlled)
│   ├── config.yaml.example     # Config example
│   └── camera_extra_info.yaml  # Camera extra info
│
├── scripts/                    # Management scripts (version-controlled)
│   ├── install.sh / install.ps1  # One-click online installation
│   ├── upgrade.sh / upgrade.ps1  # Online upgrade (version compare, backup & rollback)
│   ├── setup.sh / setup.bat    # Auto-detect platform & extract release package
│   ├── verify.sh / verify.bat  # Verify installation integrity
│   ├── start.sh / start.bat    # Start service
│   ├── stop.sh / stop.bat      # Stop service
│   ├── health_check.sh / .bat  # Health check
│   ├── auth.py                 # Mi Home OAuth authorization (cross-platform)
│   ├── snapshot.py             # Camera snapshot tool
│   └── scheduled_analysis.py   # Scheduled AI analysis
│
├── packages/                   # Downloaded release packages (gitignored)
├── bin/                        # Binary files (auto-filled by setup, gitignored)
├── lib/                        # Dynamic libraries (auto-filled by setup, gitignored)
├── data/                       # Runtime data (gitignored)
└── webui/                      # Web UI (auto-extracted by setup, gitignored)

Platform Support

Platform	Release Package	Binary	Libraries
macOS Intel	miloco-mcp-server-*-Darwin-x86_64.tar.gz	bin/miloco-mcp-server	lib/*.dylib
macOS ARM	miloco-mcp-server-*-Darwin-arm64.tar.gz	bin/miloco-mcp-server	lib/*.dylib
Linux x86_64	miloco-mcp-server-*-Linux-x86_64.tar.gz	bin/miloco-mcp-server	lib/*.so
Windows x64	miloco-mcp-server-*-Windows-x86_64.zip	bin/miloco-mcp-server.exe	lib/*.dll

Installation

Option 0: Install via AI Assistant (Easiest)

Just send the message below to your AI assistant — it will read the guide and install FeyaGate Skill for you automatically.

Supported AI Agents: OpenClaw, Claude Code, Hermes, Codex, Windsurf, Copilot, 小智AI, Cursor, and other MCP-compatible AI coding agents.

Copy and paste this prompt:

Please read https://github.com/toddpan/feyagate-skill/blob/main/QUICKSTART.md and follow the instructions to install and set up FeyaGate Skill on my machine.

The AI assistant will automatically:

1. Detect your OS and architecture
2. Run the one-click install script
3. Configure and start the service

Option 1: One-Click Online Install (Recommended)

Automatically fetches the latest version from the server — download, extract, and configure in one step:

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/toddpan/feyagate-skill/main/scripts/install.sh | bash

Windows (PowerShell):

iwr -useb https://raw.githubusercontent.com/toddpan/feyagate-skill/main/scripts/install.ps1 | iex

Custom install directory:

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/toddpan/feyagate-skill/main/scripts/install.sh | bash -s -- --dir ~/my-skill

# Windows
$env:FEYAGATE_INSTALL_DIR="D:\my-skill"; iwr -useb https://raw.githubusercontent.com/toddpan/feyagate-skill/main/scripts/install.ps1 | iex

The install script automatically:

1. Fetches the latest version info from fota.json
2. Clones the feyagate-skill repository (with scripts and config templates)
3. Downloads the binary release package for your platform and verifies MD5
4. Extracts the binary to bin/, libraries to lib/, WebUI to webui/
5. Creates the default config/config.yaml and data/ directory

Option 2: Manual Installation

Step 1: Clone the Repository

git clone https://github.com/toddpan/feyagate-skill.git
cd feyagate-skill

Step 2: Download the Release Package

Download from website: Visit www.feyagate.com to download the Skill package for your platform, then place it in the packages/ directory.

Direct download links:

# macOS Intel
curl -L -o packages/miloco-mcp-server-VERSION-Darwin-x86_64.tar.gz \
  "https://oneapi.sooncore.com/ota/feyagate-skill/miloco-mcp-server-VERSION-Darwin-x86_64.tar.gz"

# Linux x86_64
curl -L -o packages/miloco-mcp-server-VERSION-Linux-x86_64.tar.gz \
  "https://oneapi.sooncore.com/ota/feyagate-skill/miloco-mcp-server-VERSION-Linux-x86_64.tar.gz"

# Windows x64
curl -L -o packages/miloco-mcp-server-VERSION-Windows-x86_64.zip \
  "https://oneapi.sooncore.com/ota/feyagate-skill/miloco-mcp-server-VERSION-Windows-x86_64.zip"

Tip: Get the latest version info at https://oneapi.sooncore.com/ota/fota.json (search for feyagate-skill-* entries).

Step 3: Run Setup

# macOS / Linux
bash scripts/setup.sh

# Windows
scripts\setup.bat

# Or specify a package path
bash scripts/setup.sh --package /path/to/miloco-mcp-server-*.tar.gz

Step 4: Configuration

Edit config/config.yaml to set cloud region and other parameters:

server:
  http_port: 38080
  bind_address: "0.0.0.0"
auth:
  cloud_server: "cn"      # cn / de / sg / us / ru / i2

Start & Authorize

bash scripts/start.sh                # Start MCP Server
python3 scripts/auth.py              # First-time Mi Home account authorization
bash scripts/health_check.sh         # Verify status

Service Management

Action	macOS / Linux	Windows
Install/Extract	bash scripts/setup.sh	scripts\setup.bat
Verify Installation	bash scripts/verify.sh	scripts\verify.bat
Start	bash scripts/start.sh	scripts\start.bat
Stop	bash scripts/stop.sh	scripts\stop.bat
Health Check	bash scripts/health_check.sh	scripts\health_check.bat
Custom Port	bash scripts/start.sh --port 9090	scripts\start.bat --port 9090
Online Upgrade	bash scripts/upgrade.sh	powershell -File scripts\upgrade.ps1
Check for Updates	bash scripts/upgrade.sh --check	powershell -File scripts\upgrade.ps1 -Check

MCP Tool Overview

Category	Tools	Description
Device Discovery	device/list, device/specs, platform/status, gateway/info	Cross-platform device management & status query
Xiaomi Control	xiaomi/get_properties, xiaomi/set_property, xiaomi/execute_action	MIOT protocol device read/write & actions
Xiaomi Auth	xiaomi/auth_status, xiaomi/auth_url, xiaomi/auth_callback	OAuth authorization management
Scenes	scene/list, scene/trigger	Cross-platform scene management
Xiao AI Speaker	xiaoai/tts, xiaoai/play_music, xiaoai/control	TTS, music, voice control
Camera	xiaomi/camera_list, xiaomi/camera_connect, xiaomi/camera_snapshot, etc.	P2P connection, JPEG capture
Tuya	tuya/get_properties, tuya/set_property	Tuya device control
Midea	midea/get_properties, midea/set_property, midea/execute_action	Midea device control
eWeLink	ewelink/get_properties, ewelink/set_property, ewelink/execute_action	eWeLink device control
Rooms	room/list, room/set_device	Room management
Memory	memory/read, memory/add, memory/search, memory/note, etc.	Long-term memory & daily notes
Scheduling	schedule/add, schedule/list, schedule/get, etc.	Scheduled tasks
Serial/GPIO	serial/, gpio/	Extended device control

For detailed API documentation, see SKILL.md, FeyaGate_MCP_API.md, and FeyaGate_HTTP_API.md.

Upgrade

Online Upgrade (Recommended)

Automatically fetches the latest version with version comparison, backup/rollback, and service lifecycle management:

Check for new versions:

# macOS / Linux
bash scripts/upgrade.sh --check

# Windows
powershell -ExecutionPolicy Bypass -File scripts\upgrade.ps1 -Check

Perform upgrade:

# macOS / Linux (interactive confirmation)
bash scripts/upgrade.sh

# macOS / Linux (non-interactive, for automation)
bash scripts/upgrade.sh --yes

# Windows (interactive confirmation)
powershell -ExecutionPolicy Bypass -File scripts\upgrade.ps1

# Windows (non-interactive)
powershell -ExecutionPolicy Bypass -File scripts\upgrade.ps1 -Yes

Upgrade flow: stop service -> backup bin/ + lib/ -> download new version -> MD5 verify -> extract & install -> write version -> restart service -> health check. If any step fails, it automatically rolls back to the backup.

Manual Upgrade

When online upgrade is unavailable:

bash scripts/stop.sh                                          # Stop current service
cp ~/Downloads/miloco-mcp-server-NEW-VERSION.tar.gz packages/  # Place new package
bash scripts/setup.sh                                          # Re-extract (overwrite bin/ lib/)
bash scripts/start.sh                                          # Start new version

Developer: Building Release Packages

If you need to compile and package from source:

# In the miloco-mcp-server project
cd miloco-mcp-server
bash build-desktop-mac.sh --build --server-only   # macOS
# or
bash build-desktop-linux.sh --build --server-only  # Linux

# Output: app/release/miloco-mcp-server-VERSION-OS-ARCH.tar.gz

License

MIT License

---

基于 miloco-mcp-server 的 MCP Skill 封装，提供小米/米家智能设备控制、摄像头监控、小爱音箱控制等能力。

官网： www.feyagate.com

支持的 AI 助手

AI 助手	状态	集成方式
OpenClaw	已支持	MCP Skill 自动安装
Claude Code	已支持	MCP 配置自动生成
Hermes	已支持	MCP Skill 自动安装
Codex	已支持	MCP Skill 自动安装
Windsurf	已支持	MCP 配置自动生成
Copilot	已支持	MCP 配置自动生成
小智AI	已支持	MCP Skill 自动安装
Cursor	已支持	MCP 配置自动生成

项目结构

feyagate-skill/
├── SKILL.md                    # AI Agent Skill 定义（MCP 工具描述）
├── README.md                   # 项目说明（本文件）
├── QUICKSTART.md               # 快速开始指南
├── reference.md                # 完整 MCP API 参考
│
├── config/                     # 配置模板（入版本控制）
│   ├── config.yaml.example     # 配置示例
│   └── camera_extra_info.yaml  # 摄像头附加信息
│
├── scripts/                    # 管理脚本（入版本控制）
│   ├── install.sh / install.ps1  # 一键在线安装（官方发布）
│   ├── upgrade.sh / upgrade.ps1  # 在线升级（版本对比、备份回滚）
│   ├── setup.sh / setup.bat    # 自动检测平台 + 解压发布包
│   ├── verify.sh / verify.bat  # 验证安装完整性
│   ├── start.sh / start.bat    # 启动服务
│   ├── stop.sh / stop.bat      # 停止服务
│   ├── health_check.sh / .bat  # 健康检查
│   ├── auth.py                 # 米家 OAuth 授权（跨平台）
│   ├── snapshot.py             # 摄像头抓拍工具
│   └── scheduled_analysis.py   # 定时 AI 分析
│
├── packages/                   # 放入下载的发布包（gitignored）
├── bin/                        # 二进制文件（setup 自动填充，gitignored）
├── lib/                        # 动态库（setup 自动填充，gitignored）
├── data/                       # 运行时数据（gitignored）
└── webui/                      # Web UI（setup 自动解压，gitignored）

平台支持

平台	发布包格式	二进制	动态库
macOS Intel	miloco-mcp-server-*-Darwin-x86_64.tar.gz	bin/miloco-mcp-server	lib/*.dylib
macOS ARM	miloco-mcp-server-*-Darwin-arm64.tar.gz	bin/miloco-mcp-server	lib/*.dylib
Linux x86_64	miloco-mcp-server-*-Linux-x86_64.tar.gz	bin/miloco-mcp-server	lib/*.so
Windows x64	miloco-mcp-server-*-Windows-x86_64.zip	bin/miloco-mcp-server.exe	lib/*.dll

安装

方式零：让 AI 助手帮你安装（最简单）

直接把下面的消息发给你的 AI 助手，它会自动阅读安装指南并为你完成安装。

支持： OpenClaw、Claude Code、Hermes、Codex、Windsurf、Copilot、小智AI、Cursor 等各类 MCP 兼容 AI 编程助手。

复制以下提示词发送：

请阅读 https://github.com/toddpan/feyagate-skill/blob/main/QUICKSTART.md 并按照指南在我的机器上安装和配置 FeyaGate Skill。

AI 助手会自动：

1. 检测你的操作系统和架构
2. 执行一键安装脚本
3. 完成配置并启动服务

方式一：一键在线安装（推荐）

自动从服务器获取最新版本，下载、解压、配置一步到位：

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/toddpan/feyagate-skill/main/scripts/install.sh | bash

Windows (PowerShell):

iwr -useb https://raw.githubusercontent.com/toddpan/feyagate-skill/main/scripts/install.ps1 | iex

自定义安装目录：

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/toddpan/feyagate-skill/main/scripts/install.sh | bash -s -- --dir ~/my-skill

# Windows
$env:FEYAGATE_INSTALL_DIR="D:\my-skill"; iwr -useb https://raw.githubusercontent.com/toddpan/feyagate-skill/main/scripts/install.ps1 | iex

安装脚本会自动：

1. 从 fota.json 获取最新版本信息
2. 克隆 feyagate-skill 仓库（含脚本和配置模板）
3. 下载对应平台的二进制发布包并校验 MD5
4. 解压二进制文件到 bin/，动态库到 lib/，WebUI 到 webui/
5. 创建默认 config/config.yaml 和 data/ 目录

方式二：手动安装

Step 1: 克隆仓库

git clone https://github.com/toddpan/feyagate-skill.git
cd feyagate-skill

Step 2: 下载发布包

从官网下载： 访问 www.feyagate.com 下载对应平台的 Skill 包，放入 packages/ 目录。

直接下载链接：

# macOS Intel
curl -L -o packages/miloco-mcp-server-VERSION-Darwin-x86_64.tar.gz \
  "https://oneapi.sooncore.com/ota/feyagate-skill/miloco-mcp-server-VERSION-Darwin-x86_64.tar.gz"

# Linux x86_64
curl -L -o packages/miloco-mcp-server-VERSION-Linux-x86_64.tar.gz \
  "https://oneapi.sooncore.com/ota/feyagate-skill/miloco-mcp-server-VERSION-Linux-x86_64.tar.gz"

# Windows x64
curl -L -o packages/miloco-mcp-server-VERSION-Windows-x86_64.zip \
  "https://oneapi.sooncore.com/ota/feyagate-skill/miloco-mcp-server-VERSION-Windows-x86_64.zip"

提示：最新版本信息可通过 https://oneapi.sooncore.com/ota/fota.json 获取（搜索 feyagate-skill-* 类型的条目）。

Step 3: 运行 Setup

# macOS / Linux
bash scripts/setup.sh

# Windows
scripts\setup.bat

# 或指定包路径
bash scripts/setup.sh --package /path/to/miloco-mcp-server-*.tar.gz

Step 4: 配置

编辑 config/config.yaml，设置云端区域等参数：

server:
  http_port: 38080
  bind_address: "0.0.0.0"
auth:
  cloud_server: "cn"      # cn / de / sg / us / ru / i2

启动并授权

bash scripts/start.sh                # 启动 MCP Server
python3 scripts/auth.py              # 首次授权米家账号
bash scripts/health_check.sh         # 验证状态

服务管理

操作	macOS / Linux	Windows
安装/解压	bash scripts/setup.sh	scripts\setup.bat
验证安装	bash scripts/verify.sh	scripts\verify.bat
启动	bash scripts/start.sh	scripts\start.bat
停止	bash scripts/stop.sh	scripts\stop.bat
健康检查	bash scripts/health_check.sh	scripts\health_check.bat
自定义端口	bash scripts/start.sh --port 9090	scripts\start.bat --port 9090
在线升级	bash scripts/upgrade.sh	powershell -File scripts\upgrade.ps1
检查更新	bash scripts/upgrade.sh --check	powershell -File scripts\upgrade.ps1 -Check

MCP 工具概览

类别	工具	说明
设备发现	device/list, device/specs, platform/status, gateway/info	跨平台设备管理与状态查询
小米控制	xiaomi/get_properties, xiaomi/set_property, xiaomi/execute_action	MIOT 协议设备读写与动作
小米授权	xiaomi/auth_status, xiaomi/auth_url, xiaomi/auth_callback	OAuth 授权管理
场景	scene/list, scene/trigger	跨平台场景管理
小爱音箱	xiaoai/tts, xiaoai/play_music, xiaoai/control	TTS、音乐、语音控制
摄像头	xiaomi/camera_list, xiaomi/camera_connect, xiaomi/camera_snapshot 等	P2P 连接、JPEG 抓拍
涂鸦	tuya/get_properties, tuya/set_property	涂鸦设备控制
美的	midea/get_properties, midea/set_property, midea/execute_action	美的设备控制
易微联	ewelink/get_properties, ewelink/set_property, ewelink/execute_action	eWeLink 设备控制
房间	room/list, room/set_device	房间管理
记忆	memory/read, memory/add, memory/search, memory/note 等	长期记忆与每日笔记
定时任务	schedule/add, schedule/list, schedule/get 等	定时调度
串口/GPIO	serial/, gpio/	扩展设备控制

详细 API 文档见 SKILL.md、FeyaGate_MCP_API.md 和 FeyaGate_HTTP_API.md。

升级

在线升级（推荐）

自动从服务器获取最新版本，支持版本对比、备份回滚和服务生命周期管理：

检查是否有新版本：

# macOS / Linux
bash scripts/upgrade.sh --check

# Windows
powershell -ExecutionPolicy Bypass -File scripts\upgrade.ps1 -Check

执行升级：

# macOS / Linux（交互式确认）
bash scripts/upgrade.sh

# macOS / Linux（非交互模式，适合自动化）
bash scripts/upgrade.sh --yes

# Windows（交互式确认）
powershell -ExecutionPolicy Bypass -File scripts\upgrade.ps1

# Windows（非交互模式）
powershell -ExecutionPolicy Bypass -File scripts\upgrade.ps1 -Yes

升级流程：停止服务 -> 备份 bin/ + lib/ -> 下载新版本 -> MD5 校验 -> 解压安装 -> 写入版本号 -> 重启服务 -> 健康检查。任何步骤失败将自动回滚到备份版本。

手动升级

当在线升级不可用时，可手动操作：

bash scripts/stop.sh                                          # 停止当前服务
cp ~/Downloads/miloco-mcp-server-NEW-VERSION.tar.gz packages/  # 放入新包
bash scripts/setup.sh                                          # 重新解压（覆盖 bin/ lib/）
bash scripts/start.sh                                          # 启动新版本

开发者：打包发布包

如果你需要从源码编译并打包：

# 在 miloco-mcp-server 项目中
cd miloco-mcp-server
bash build-desktop-mac.sh --build --server-only   # macOS
# 或
bash build-desktop-linux.sh --build --server-only  # Linux

# 产出: app/release/miloco-mcp-server-VERSION-OS-ARCH.tar.gz

许可证

MIT License