FeyaGate Skill — MCP Smart Home Gateway
Control smart home devices (lights, cameras, AC, speakers) from any AI agent via MCP protocol. Supports Xiaomi · Tuya · Midea · eWeLink · Serial · GPIO.
Prerequisites
- Python 3.9+
- macOS / Linux / Windows
curl(for installation)
Before Using Any Tool
Run this check before calling any FeyaGate MCP tool:
feyagate status
- RUNNING → proceed with tool calls
- STOPPED or command not found → run
feyagate startfirst - Not installed →
pip install feyagate-skill && feyagate setup && feyagate start
Quick Start
pip install feyagate-skill # Install Python package
feyagate setup # Download MCP server binary (~30MB)
feyagate start # Start service on localhost:38080
feyagate install-claude # Register with your AI agent
feyagate auth # Authorize smart home platform
Other agents: install-cursor, install-openclaw, install-hermes, install-codex, install-windsurf, install-copilot
Full guide: QUICKSTART.md
Server Lifecycle
| Action | Command |
|---|---|
| Install binary | feyagate setup [--dir PATH] |
| Start | feyagate start [--port PORT] |
| Stop | feyagate stop |
| Restart | feyagate restart [--port PORT] |
| Status | feyagate status |
| Logs | feyagate log [-n 50] |
| Update | feyagate update |
| Auth | feyagate auth [--status] [--code CODE] |
Cross-Platform Tools
These tools work across all platforms (system auto-detects device platform):
| Tool | Arguments | Returns |
|---|---|---|
device/list |
filter (string[]), platform (opt) |
Devices with platform field |
device/specs |
deviceId (string) |
Platform-specific spec: properties, actions |
platform/status |
— | All platform connection/auth/sync status |
gateway/info |
— | Version, device count, ports |
scene/list |
platform (string) |
Scene list |
scene/trigger |
platform, sceneId |
Trigger result |
> Parameter convention: device/specs uses deviceId (camelCase); platform-specific tools (xiaomi/*, tuya/*) use device_id (snake_case).
Sub-Skill Loading Strategy
The main skill provides cross-platform tools. Load sub-skills on demand based on the user's platform:
| Sub-Skill | File | When to Load |
|---|---|---|
| feyagate-xiaomi | skills/xiaomi.md | Xiaomi/Mi Home devices, cameras, XiaoAI speakers |
| feyagate-tuya | skills/tuya.md | Tuya/Smart Life devices |
| feyagate-midea | skills/midea.md | Midea/美的 appliances |
| feyagate-ewelink | skills/ewelink.md | eWeLink/Sonoff devices |
| feyagate-automation | skills/automation.md | Schedule, triggers, rooms, memory |
| feyagate-extension | skills/extension.md | Serial, GPIO, Xiaozhi AI, license |
Workflow: device/list → device/specs → identify platform → load corresponding sub-skill
License
- Free: Xiaomi platform (device control, cameras, XiaoAI, MCP proxy)
- Licensed: All platforms (Xiaomi + Tuya + Midea + eWeLink)
tuya/set_property,midea/set_property,ewelink/set_propertyreturnlicense_requiredon free editionget_propertiesand read tools work without license
Configuration
~/.feyagate/config/config.yaml:
server:
http_port: 38080
ws_port: 8765
bind_address: "0.0.0.0"
auth:
cloud_server: "cn" # cn / de / sg / us / ru / i2
camera:
frame_interval: 500
jpeg_quality: 90
xiaozhi:
endpoint: "" # ws:// or wss:// (empty = disabled)
Troubleshooting
| Symptom | Fix |
|---|---|
command not found: feyagate |
pip install feyagate-skill |
FeyaGate not installed |
feyagate setup |
connection refused |
feyagate start |
authorized: false |
feyagate auth or platform auth tool |
Tool not found |
Check tools/list output |
license_required |
Set license via license/set tool |
Full API docs: FeyaGate_MCP_API.md, FeyaGate_HTTP_API.md
