Control smart home devices (lights, cameras, AC, speakers) from any AI agent via MCP protocol. Supports Xiaomi · Tuya · Midea · eWeLink · Serial · GPIO.
curl (for installation)Run this check before calling any FeyaGate MCP tool:
feyagate status
feyagate start firstpip install feyagate-skill && feyagate setup && feyagate startpip 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
| 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] |
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).
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
tuya/set_property, midea/set_property, ewelink/set_property return license_required on free editionget_properties and read tools work without license~/.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)
| 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
共 3 个版本