概述

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 start first
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_property return license_required on free edition
get_properties and 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

版本历史

共 1 个版本

v1.0.0 从ClawHub迁移发布当前

2026-06-07 11:40 安全安全

安全检测

腾讯云安全 (Keen)

安全，无风险

查看报告

腾讯云安全 (Sanbu)