Feyagate

MCP smart home gateway for AI agents. Control Xiaomi, Tuya, Midea, eWeLink, cameras, and XiaoAI speakers via MCP protocol.

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:

bash

feyagate status

• RUNNING → proceed with tool calls
• STOPPED or command not found → run feyagate start first
• Not installed → pip install feyagate-skill && feyagate setup && feyagate start

Quick Start

bash

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_property return license_required on free edition
  • get_properties and read tools work without license

Configuration

~/.feyagate/config/config.yaml:

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