What makes Feyagate notable?

979 downloads. Trust evidence available

How should Feyagate be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

Feyagate

MCP smart home gateway for AI agents. Control Xiaomi, Tuya, Midea, eWeLink, cameras, and XiaoAI speakers via MCP protocol. Skill: Feyagate Owner: toddpan Summary: MCP smart home gateway for AI agents. Control Xiaomi, Tuya, Midea, eWeLink, cameras, and XiaoAI speakers via MCP protocol. Tags: latest:1.0.9 Version history: v1.0.9 | 2026-06-05T23:45:13.858Z | auto - Major refactor: skill was simplified with most Python code and scripts removed. - SKILL.md restructured and updated for clarity, with enhanced metadata and improved platform summ

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

979

Updated

Oct 11, 2026

Version

1.0.9

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 979 downloads reported by the source. Last updated 10/11/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 11, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 11, 2026
Adoption signal: 979 downloadsadoption · observed Oct 11, 2026
Latest release: 1.0.9release · observed Jun 5, 2026
Handshake status: UNKNOWNsecurity

What changed

Newest first. Only changes that point at a source are listed.

Release 1.0.9release
- Major refactor: skill was simplified with most Python code and scripts removed. - SKILL.md restructured and updated for clarity, with enhanced metadata and improved platform summaries. - Documentation greatly condensed; details now reference QUICKSTART.md and companion guides. - Most implementation files, scripts, and secondary docs deleted; setup is now external or delegated. - Troubleshooting, license, and configuration sections streamlined. - Sub-skill loading, naming, and CLI instructions clarified.
Observed Jun 5, 2026 · source

Install and run

Setup complexity: low.

clawhub skill install s175wd5ntjvmg1jg3apxgq5csn8597qy:feyagate

Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-toddpan-feyagate/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

148,510 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: feyagate
description: MCP smart home gateway for AI agents. Control Xiaomi, Tuya, Midea, eWeLink, cameras, and XiaoAI speakers via MCP protocol.
version: 1.2.31
emoji: "🏠"
homepage: https://www.feyagate.com
metadata:
  openclaw:
    requires:
      bins:
        - curl
      config:
        - ~/.feyagate/config/config.yaml
    envVars:
      - name: FEyagate_INSTALL_DIR
        required: false
        description: Override installation directory (default ~/.feyagate)
      - name: FEyagate_PORT
        required: false
        description: HTTP port for the MCP proxy server (default 38080)
sub_skills:
  - name: feyagate-xiaomi
    file: skills/xiaomi.md
    trigger: Xiaomi, Mi Home, MIOT, 小米, camera, P2P, XiaoAI, 小爱, TTS, speaker, 摄像头
  - name: feyagate-tuya
    file: skills/tuya.md
    trigger: Tuya, Smart Life, 涂鸦, DP code, QR auth
  - name: feyagate-midea
    file: skills/midea.md
    trigger: Midea, 美居, 美的, AC, air conditioner, 空调
  - name: feyagate-ewelink
    file: skills/ewelink.md
    trigger: eWeLink, Sonoff, iTEAD, switch, relay
  - name: feyagate-automation
    file: skills/automation.md
    trigger: schedule, timer, trigger, automation, room, memory, note, 定时, 自动化, 房间, 记忆
  - name: feyagate-extension
    file: skills/extension.md
    trigger: serial, RS485, UART, GPIO, Xiaozhi, 小智, license, config, stats, 统计
---

# 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](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 |
|------|---------

_meta.json

{
  "ownerId": "kn70xdk1j9emqkf281q83fvzb1858rny",
  "slug": "feyagate",
  "version": "1.0.9",
  "publishedAt": 1780703113858
}

FeyaGate_HTTP_API.md

# FeyaGate HTTP API 文档

> **适用产品**: miloco-mcp-server (桌面版虚拟网关 / ESP32 物理网关)
> **基础 URL**: `http://<网关IP>:<port>` (桌面版默认 `38080`)
> **协议**: HTTP REST + MCP JSON-RPC 2.0
> **CORS**: 全局开放 `Access-Control-Allow-Origin: *`

---

## 目录

- [1. 概述](#1-概述)
- [2. HTTP REST 接口](#2-http-rest-接口)
  - [2.1 健康检查](#21-健康检查)
  - [2.2 OAuth 授权回调](#22-oauth-授权回调)
  - [2.3 网关信息](#23-网关信息)
  - [2.4 授权管理](#24-授权管理)
- [3. MCP JSON-RPC 接口](#3-mcp-json-rpc-接口)
  - [3.1 协议说明](#31-协议说明)
  - [3.2 协议方法](#32-协议方法)
- [4. 米家平台](#4-米家平台)
- [5. 小爱音箱](#5-小爱音箱)
- [6. 小智平台](#6-小智平台)
- [7. 授权与网关](#7-授权与网关)
- [8. Vision AI](#8-vision-ai)
- [9. 触发规则](#9-触发规则)
- [10. 配置管理](#10-配置管理)
- [11. 统计数据](#11-统计数据)
- [12. 多平台设备](#12-多平台设备)
- [13. 定时任务](#13-定时任务)
- [14. 技能管理](#14-技能管理)

---

## 1. 概述

FeyaGate 网关提供两类 HTTP 接口：

1. **HTTP REST 接口** — 标准 GET/POST/DELETE 端点，主要用于健康检查、OAuth 授权回调、网关信息和授权管理。
2. **MCP JSON-RPC 接口** — 所有智能家居控制、设备管理等核心功能通过 `POST /mcp/http` 以 JSON-RPC 2.0 协议调用。

---

## 2. HTTP REST 接口

### 2.1 健康检查

```
GET /health
```

**响应示例**:
```json
{"status": "ok"}
```

### 2.2 OAuth 授权回调

#### 2.2.1 OAuth 回调

```
GET /auth/callback?code=xxx&source=browser
```

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `code` | string | 是 | OAuth 授权码 |
| `source` | string | 否 | 来源标识，`browser` 时触发页面重定向 |

**响应**: 成功时返回 HTML 页面显示授权结果；失败时返回错误提示。

#### 2.2.2 浏览器 OAuth 回调

```
GET /auth/browser-callback?code=xxx
```

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `code` | string | 是 | OAuth 授权码 |

**响应**: 重定向到 `/#/?auth=success` 或 `/#/?auth=failed`。

#### 2.2.3 浏览器 OAuth 启动页

```
GET /auth/browser-start?oauth_url=xxx&callback=xxx
```

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `oauth_url` | string | 是 | OAuth 授权 URL |
| `callback` | string | 是 | 回调地址 |

**响应**: 返回 HTML 页面，含小米登录按钮，500ms 后自动跳转授权。

### 2.3 网关信息

```
GET /api/v1/gateway/info
```

**响应示例**:
```json
{
  "code": 0,
  "data": {
    "version": "v1.2.14",
    "platform": "linux",
    "device_id": "xxx",
    "edition": "pro",
    "licensed": true
  }
}
```

### 2.4 授权管理

#### 获取授权状态

```
GET /api/v1/gateway/license
```

**响应示例**:
```json
{
  "code": 0,
  "data": {
    "edition": "pro",
    "status": "active",
    "product": "feyagate-linux",
    "license_key": "FG-xxxx-****-xxxx"
  }
}
```

#### 写入授权码

```
POST /api/v1/gateway/license
Content-Type: application/json
```

**请求体**:
```json
{
  "license_key": "FG-XXXX-XXXX-XXXX",
  "product": "feyagate-linux"
}
```

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `license_key` | string | 是 | 授权码，格式 `FG-XXXX-XXXX-XXXX` |
| `product` | string | 否 | 产品标识，默认使用配置文件中的值 |

**响应示例**:
```json
{
  "code": 0,
  "data": {
    "edition": "pro",
    "status": "active",
    "activated": true
  }
}
```

#### 清除授权

```
DELETE /api/v1/gateway/license
```

**响应示例**:
```json
{
  "code": 0,
  "data": { "edition": "free", "status": "inactive" },
  "message": "授权已清除, 恢复免费版"
}
```

---

## 3. MCP JSON-RPC 接口

### 3.1 协议说明

所有 MCP 工具通过单一端点调用：

```
POST /mcp/http
Content-Type: application/json

FeyaGate_MCP_API.md

# FeyaGate MCP API 文档

> **适用产品**: miloco-mcp-server (桌面版虚拟网关)
> **协议**: MCP (Model Context Protocol) JSON-RPC 2.0
> **MCP 端点**: `POST http://<网关IP>:38080/mcp/http`
> **协议版本**: `2025-03-26`

---

## 目录

- [1. 连接指南](#1-连接指南)
- [2. JSON-RPC 2.0 规范](#2-json-rpc-20-规范)
- [3. 协议方法](#3-协议方法)
- [4. MCP Tools 总览 (76 个)](#4-mcp-tools-总览-76-个)
- [5. 通用设备工具](#5-通用设备工具)
- [6. 小米 (Xiaomi) 平台](#6-小米-xiaomi-平台)
- [7. 涂鸦 (Tuya) 平台](#7-涂鸦-tuya-平台)
- [8. 美的 (Midea) 平台](#8-美的-midea-平台)
- [9. 易微联 (eWeLink) 平台](#9-易微联-ewelink-平台)
- [10. 小爱音箱控制](#10-小爱音箱控制)
- [11. 小智平台](#11-小智平台)
- [12. 认证与平台管理](#12-认证与平台管理)
- [13. Vision AI](#13-vision-ai)
- [14. 触发规则](#14-触发规则)
- [15. 定时任务](#15-定时任务)
- [16. 技能系统](#16-技能系统)
- [17. 配置管理](#17-配置管理)
- [18. 统计数据](#18-统计数据)
- [19. 授权码管理](#19-授权码管理)
- [20. 网关信息](#20-网关信息)
- [21. 错误码](#21-错误码)
- [附录: 快速示例](#附录-快速示例)

---

## 1. 连接指南

所有 MCP 调用均通过 `POST /mcp/http` 以 JSON-RPC 2.0 格式发送，无需事先握手。

```bash
# 初始化
curl -X POST http://localhost:38080/mcp/http \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"MyClient","version":"1.0.0"}}}'

# 列出所有工具
curl -s -X POST http://localhost:38080/mcp/http \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'
```

> **无状态**: 服务器不维持 HTTP 会话状态，不返回 `Mcp-Session-Id` header，每次请求均为无状态调用。
>
> **无 WebSocket**: 服务器不提供 inbound WebSocket 端点。`/mcp` WebSocket 路径不存在。服务器作为 WebSocket **客户端**主动连接小智平台，由 `xiaozhi/*` 工具管理。

---

## 2. JSON-RPC 2.0 规范

### 请求结构

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "<工具名>",
    "arguments": { ... }
  }
}
```

### 成功响应

工具返回值被包装为 MCP content 格式：

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      { "type": "text", "text": "{\"success\":true,...}" }
    ]
  }
}
```

> 工具返回的 JSON 对象会被序列化为字符串放在 `content[0].text` 中。

### 图片响应

当工具返回含 `images` 数组（含 `data_url` 字段）的结果时，服务器会自动提取图片为独立的 MCP image content：

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      { "type": "text", "text": "{\"camera_id\":\"xxx\",\"images\":[...]}" },
      { "type": "image", "data": "<base64>", "mimeType": "image/jpeg" }
    ]
  }
}
```

### 错误响应

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "error": { "code": -32601, "message": "Tool not found: unknown/tool" }
}
```

### 工具执行异常

当工具 handler 抛出异常时，返回 `isError: true`：

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      { "type": "text", "text": "{\"error\":\"exception message\"}" }
    ],
    "isError": true
  }
}
```

---

## 3. 协议方法

| 方法 | 说明 |
|------|------|
| `initialize` | MCP 协议握手 |
| `ping` | 保活心跳 |
| `tools/list` | 列出所有已注册工具 |
| `tools/call` | 调用指定工具 |
| `notifications/initialized` | 初始化完成通知（无响应） |

### initialize

```json
{
  "jsonrpc": "2.0", "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-03-26",
    "capabilities": {},
    "clientI

QUICKSTART.md

# FeyaGate Skill — Quick Start Guide

```
  _____                 ____       _
 |  ___|__ _   _  __ _ / ___| __ _| |_ ___
 | |_ / _ \ | | |/ _` | |  _ / _` | __/ _ \
 |  _|  __/ |_| | (_| | |_| | (_| | ||  __/
 |_|  \___|\__, |\__,_|\____|\__,_|\__\___|
           |___/
```

> **For AI Assistants (OpenClaw, Claude Code, Hermes, Codex, Windsurf, Copilot, 小智AI, Cursor):**
> Follow Steps 1-4 sequentially. Report progress at each step. Do NOT skip steps.
> Steps marked with **[AUTO]** can be executed without asking the user.
> Steps marked with **[ASK]** require user input before proceeding.

## Prerequisites

- Python 3.9+
- Internet access (for downloading MCP server binary ~30MB)

## One-Line Install [AUTO]

**macOS / Linux** — installs the Python package and MCP server binary in one step:

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

**Windows (PowerShell):**

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

After one-line install, skip to **Step 3** (install agent skill). If you prefer manual steps, continue below.

> **For developers:** Clone the repo and use `pip install -e .` instead of the one-line script — see Step 1 Option B.

## Step 1: Install [AUTO]

**Option A — from PyPI (standard online install):**

```bash
pip install feyagate-skill
```

**Option B — from source (developers / contributors):**

```bash
git clone https://github.com/toddpan/feyagate-skill.git
cd feyagate-skill
pip install -e ".[dev]"     # includes pytest and other dev dependencies
```

Verify:

```bash
feyagate --version
```

## Step 2: Setup & Start [AUTO]

Download and install the MCP server binary (may take 1-2 minutes):

```bash
feyagate setup
```

Default directory: `~/.feyagate`. Customize with `feyagate setup --dir ~/my-feyagate`.

Start the service:

```bash
feyagate start
```

Verify:

```bash
feyagate status
```

Service URL: `http://localhost:38080/mcp/http`. Custom port: `feyagate start --port 9090`.

## Step 3: Install as AI Agent Skill [ASK]

> **IMPORTANT:** This step installs the FeyaGate skill (SKILL.md + sub-skills) for the AI agent you are currently running in.
> Ask the user: "Which AI agent should I install for?" or detect from the environment.

```bash
feyagate install-claude     # Claude Code
feyagate install-cursor     # Cursor
feyagate install-openclaw   # OpenClaw
feyagate install-hermes     # Hermes Agent
feyagate install-windsurf   # Windsurf
feyagate install-copilot    # GitHub Copilot (VS Code)
feyagate install-codex      # OpenAI Codex CLI
```

After install, **restart the AI agent** to load the skill.

## Step 4: Authorize Smart Home Platform [ASK]

> Ask the user which platform(s) they want to authorize.

### Xiaomi / Mi Home (OAuth)

```bash
feyagate auth --status    # Check current status
feyagate auth             # Interactive OAuth authorization
```

The interactive flow will output a URL → user ope

Github ReposUpdated 3d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW

Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular