feyagate-skill 1.2.2__py3-none-any.whl

feyagate_skill/__init__.py

@@ -0,0 +1,9 @@
+"""FeyaGate Skill - MCP Smart Home Gateway for AI Agents."""
+
+__version__ = "1.2.2"
+__author__ = "panzuji"
+
+DEFAULT_INSTALL_DIR = "~/.feyagate"
+FOTA_URL = "https://oneapi.sooncore.com/ota/fota.json"
+MCP_DEFAULT_PORT = 38080
+MCP_DEFAULT_HOST = "127.0.0.1"

feyagate_skill/auth.py

@@ -0,0 +1,133 @@
+"""Xiaomi account authorization tool."""
+
+import json
+import sys
+import time
+from pathlib import Path
+from urllib.parse import urlparse, parse_qs
+
+from . import MCP_DEFAULT_HOST, MCP_DEFAULT_PORT
+from .mcp import mcp_call
+
+COLORS = {
+    'reset': '\033[0m', 'red': '\033[91m', 'green': '\033[92m',
+    'yellow': '\033[93m', 'blue': '\033[94m', 'cyan': '\033[96m',
+    'bold': '\033[1m',
+}
+
+
+def _c(name, text):
+    return f"{COLORS.get(name, '')}{text}{COLORS['reset']}"
+
+
+def _tool_map(tool):
+    mapping = {
+        "auth/status": "xiaomi/auth_status",
+        "auth/url": "xiaomi/auth_url",
+        "auth/callback": "xiaomi/auth_callback",
+    }
+    return mapping.get(tool, tool)
+
+
+def _mcp(host, port, tool, arguments=None):
+    return mcp_call(host, port, _tool_map(tool), arguments)
+
+
+def check_status(host, port):
+    status = _mcp(host, port, "auth/status")
+    authorized = status.get("authorized", False)
+    remaining = status.get("remaining_seconds", 0)
+
+    if authorized:
+        hours = remaining // 3600
+        mins = (remaining % 3600) // 60
+        days = hours // 24
+        hours = hours % 24
+        time_str = f"{days}d " if days > 0 else ""
+        time_str += f"{hours}h {mins}m" if hours > 0 or mins > 0 else "expiring soon"
+        print(_c('green', f"  Authorized, remaining: {time_str}"))
+        return True
+    else:
+        print(_c('red', "  Not authorized"))
+        return False
+
+
+def get_auth_url(host, port):
+    result = _mcp(host, port, "auth/url")
+    return result.get("url", "")
+
+
+def submit_code(host, port, code):
+    code_input = code.strip()
+    if code_input.startswith("http://") or code_input.startswith("https://"):
+        parsed = urlparse(code_input)
+        params = parse_qs(parsed.query)
+        code_list = params.get("code", [])
+        if not code_list:
+            print(_c('red', "  No 'code' parameter found in URL"))
+            return False
+        code_input = code_list[0]
+
+    print(_c('yellow', f"  Submitting auth code: {code_input[:10]}..."))
+    result = _mcp(host, port, "auth/callback", {"code": code_input})
+
+    if "error" in result:
+        print(_c('red', f"  Auth failed: {result['error']}"))
+        return False
+
+    time.sleep(1)
+    if check_status(host, port):
+        return True
+    else:
+        print(_c('yellow', "  Code submitted but status not updated."))
+        return False
+
+
+def do_auth(host=None, port=None, code=None, status_only=False):
+    """Run the auth flow."""
+    host = host or MCP_DEFAULT_HOST
+    port = port or MCP_DEFAULT_PORT
+
+    if status_only:
+        print("=== Auth Status ===")
+        check_status(host, port)
+        return
+
+    if code:
+        print("=== Submit Auth Code ===")
+        if submit_code(host, port, code):
+            print(_c('green', "\nAuthorization successful!"))
+        return
+
+    # Interactive flow
+    print("=" * 50)
+    print(_c('blue', "  Xiaomi Account Authorization"))
+    print("=" * 50)
+    print()
+
+    print("Step 1: Check current status")
+    if check_status(host, port):
+        print(_c('yellow', "\nAlready authorized. Re-auth after token expires."))
+        return
+
+    print()
+    print("Step 2: Get authorization URL")
+    auth_url = get_auth_url(host, port)
+    if not auth_url:
+        print(_c('red', "  Cannot get auth URL. Is MCP server running?"))
+        return
+
+    print(_c('green', "  Auth URL generated"))
+    print(f"\n  {_c('cyan', auth_url)}")
+    print(_c('yellow', "\n  Open URL in browser, then copy the full redirect URL"))
+    print(_c('yellow', "  (The 'page not found' error is normal)"))
+    print()
+
+    print("Step 3: Submit auth code")
+    callback_url = input("Paste the full callback URL: ").strip()
+    if not callback_url:
+        print(_c('red', "  No input"))
+        return
+
+    if submit_code(host, port, callback_url):
+        print(_c('green', "\nAuthorization complete!"))

feyagate_skill/cli.py

@@ -0,0 +1,212 @@
+"""FeyaGate Skill CLI - Main entry point."""
+
+import argparse
+import json
+import os
+import sys
+from pathlib import Path
+
+from . import __version__, DEFAULT_INSTALL_DIR, MCP_DEFAULT_PORT
+
+
+def _install_claude():
+    """Configure Claude Code MCP settings."""
+    claude_config = Path.home() / ".claude.json"
+    install_dir = Path(os.path.expanduser(DEFAULT_INSTALL_DIR))
+    binary = install_dir / "bin" / "miloco-mcp-server"
+
+    if not binary.exists():
+        print("ERROR: MCP server not installed. Run: feyagate setup")
+        return False
+
+    config = {}
+    if claude_config.exists():
+        try:
+            config = json.loads(claude_config.read_text(encoding="utf-8"))
+        except Exception:
+            config = {}
+
+    mcp_servers = config.setdefault("mcpServers", {})
+    mcp_servers["feyagate"] = {
+        "type": "streamable-http",
+        "url": "http://localhost:38080/mcp/http",
+    }
+
+    claude_config.write_text(json.dumps(config, indent=2, ensure_ascii=False), encoding="utf-8")
+    print(f"Added 'feyagate' MCP server to {claude_config}")
+    print(f"  URL: http://localhost:38080/mcp/http")
+    print()
+    print("Make sure to start the server: feyagate start")
+    return True
+
+
+def _install_cursor():
+    """Configure Cursor MCP settings."""
+    cursor_config = Path.home() / ".cursor" / "mcp.json"
+    install_dir = Path(os.path.expanduser(DEFAULT_INSTALL_DIR))
+    binary = install_dir / "bin" / "miloco-mcp-server"
+
+    if not binary.exists():
+        print("ERROR: MCP server not installed. Run: feyagate setup")
+        return False
+
+    cursor_config.parent.mkdir(parents=True, exist_ok=True)
+
+    config = {}
+    if cursor_config.exists():
+        try:
+            config = json.loads(cursor_config.read_text(encoding="utf-8"))
+        except Exception:
+            config = {}
+
+    mcp_servers = config.setdefault("mcpServers", {})
+    mcp_servers["feyagate"] = {
+        "type": "streamable-http",
+        "url": "http://localhost:38080/mcp/http",
+    }
+
+    cursor_config.write_text(json.dumps(config, indent=2, ensure_ascii=False), encoding="utf-8")
+    print(f"Added 'feyagate' MCP server to {cursor_config}")
+    print(f"  URL: http://localhost:38080/mcp/http")
+    print()
+    print("Make sure to start the server: feyagate start")
+    return True
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="feyagate",
+        description="FeyaGate Skill - MCP Smart Home Gateway for AI Agents",
+    )
+    parser.add_argument("--version", action="version", version=f"feyagate-skill {__version__}")
+
+    sub = parser.add_subparsers(dest="command", help="Available commands")
+
+    # setup
+    p_setup = sub.add_parser("setup", help="Download and install MCP server binary")
+    p_setup.add_argument("--dir", default=None, help="Install directory (default: ~/.feyagate)")
+
+    # start
+    p_start = sub.add_parser("start", help="Start MCP server")
+    p_start.add_argument("--port", type=int, default=None, help="HTTP port (default: from config)")
+
+    # stop
+    sub.add_parser("stop", help="Stop MCP server")
+
+    # restart
+    p_restart = sub.add_parser("restart", help="Restart MCP server")
+    p_restart.add_argument("--port", type=int, default=None, help="HTTP port")
+
+    # status
+    sub.add_parser("status", help="Show server status")
+
+    # log
+    p_log = sub.add_parser("log", help="Show server log")
+    p_log.add_argument("-n", "--lines", type=int, default=30, help="Number of lines")
+
+    # auth
+    p_auth = sub.add_parser("auth", help="Xiaomi account authorization")
+    p_auth.add_argument("--host", default=None, help="MCP host")
+    p_auth.add_argument("--port", type=int, default=None, help="MCP port")
+    p_auth.add_argument("--status", action="store_true", help="Check auth status only")
+    p_auth.add_argument("--code", default=None, help="Submit auth code directly")
+
+    # snapshot
+    p_snap = sub.add_parser("snapshot", help="Camera snapshot capture")
+    p_snap.add_argument("--host", default=None)
+    p_snap.add_argument("--port", type=int, default=None)
+    p_snap.add_argument("--list", action="store_true", help="List cameras")
+    p_snap.add_argument("--camera-id", default=None, help="Camera DID")
+    p_snap.add_argument("--connect", action="store_true", help="Connect before snapshot")
+    p_snap.add_argument("--channel", type=int, default=0)
+    p_snap.add_argument("--count", type=int, default=1)
+    p_snap.add_argument("--output-dir", default=None)
+
+    # scheduled
+    p_sched = sub.add_parser("scheduled", help="Scheduled camera analysis")
+    p_sched.add_argument("--host", default=None)
+    p_sched.add_argument("--port", type=int, default=None)
+    p_sched.add_argument("--camera-id", action="append", required=True, help="Camera DID (repeatable)")
+    p_sched.add_argument("--channel", type=int, default=0)
+    p_sched.add_argument("--interval", type=int, default=300, help="Seconds between captures")
+    p_sched.add_argument("--output-dir", default=None)
+    p_sched.add_argument("--prompt", default="", help="AI analysis prompt")
+    p_sched.add_argument("--auto-connect", action="store_true")
+    p_sched.add_argument("--max-runs", type=int, default=0, help="0 = unlimited")
+    p_sched.add_argument("--one-shot", action="store_true")
+
+    # install-claude
+    sub.add_parser("install-claude", help="Configure Claude Code MCP settings")
+
+    # install-cursor
+    sub.add_parser("install-cursor", help="Configure Cursor MCP settings")
+
+    # upgrade
+    sub.add_parser("upgrade", help="Upgrade MCP server to latest version")
+
+    args = parser.parse_args()
+
+    if not args.command:
+        parser.print_help()
+        return
+
+    if args.command == "setup":
+        from .installer import do_setup
+        do_setup(args.dir)
+
+    elif args.command == "start":
+        from .service import do_start
+        do_start(args.port)
+
+    elif args.command == "stop":
+        from .service import do_stop
+        do_stop()
+
+    elif args.command == "restart":
+        from .service import do_stop, do_start
+        do_stop()
+        do_start(args.port)
+
+    elif args.command == "status":
+        from .service import do_status
+        do_status()
+
+    elif args.command == "log":
+        from .service import do_log
+        do_log(args.lines)
+
+    elif args.command == "auth":
+        from .auth import do_auth
+        do_auth(host=args.host, port=args.port, code=args.code, status_only=args.status)
+
+    elif args.command == "snapshot":
+        from .snapshot import do_snapshot
+        do_snapshot(
+            host=args.host, port=args.port, camera_id=args.camera_id,
+            connect=args.connect, channel=args.channel, count=args.count,
+            output_dir=args.output_dir, list_cameras=args.list,
+        )
+
+    elif args.command == "scheduled":
+        from .scheduled import do_scheduled
+        do_scheduled(
+            host=args.host, port=args.port, camera_ids=args.camera_id,
+            channel=args.channel, interval=args.interval,
+            output_dir=args.output_dir, prompt=args.prompt,
+            auto_connect=args.auto_connect, max_runs=args.max_runs,
+            one_shot=args.one_shot,
+        )
+
+    elif args.command == "install-claude":
+        _install_claude()
+
+    elif args.command == "install-cursor":
+        _install_cursor()
+
+    elif args.command == "upgrade":
+        from .installer import do_setup
+        do_setup()
+
+
+if __name__ == "__main__":
+    main()

feyagate_skill/data/SKILL.md

@@ -0,0 +1,115 @@
+---
+name: feyagate
+description: MCP smart home gateway skill for AI agents (OpenClaw, Claude Code, Hermes, Codex, Windsurf, Copilot, 小智AI). Control multi-platform IoT devices via MCP protocol — supports Xiaomi/Mi Home, Tuya, Midea, eWeLink, Serial, and GPIO platforms. Provides cross-platform device discovery and control, MIOT device properties, XiaoAI speaker TTS/music, camera P2P streaming and snapshots, scheduled tasks, trigger automation, vision AI analysis, memory system, room management, and skill management. Use when working with smart home, IoT device control, home automation, Xiaomi, Tuya, Midea, eWeLink, MIOT protocol, cameras, surveillance, XiaoAI speakers, TTS, automation, scheduling, OpenClaw skill, Hermes skill, MCP server, MCP skill, or AI agent tool.
+---
+
+# FeyaGate Skill — MCP Smart Home Gateway for AI Agents
+
+MCP-based multi-platform smart home gateway supporting Xiaomi, Tuya, Midea, eWeLink, Serial, and GPIO. Compatible with OpenClaw, Claude Code, Hermes, Codex, Windsurf, Copilot, 小智AI and other MCP-compatible AI agents.
+
+**Dual API endpoints:**
+
+| Endpoint | Protocol | URL |
+|----------|----------|-----|
+| MCP (PC proxy) | Streamable HTTP JSON-RPC 2.0 | `http://localhost:38080/mcp/http` |
+| MCP (ESP32 gateway) | WebSocket / Streamable HTTP | `ws://<gateway>:8765/mcp` / `http://<gateway>:8765/mcp/http` |
+| HTTP REST (ESP32 gateway) | REST API | `http://<gateway>:8080/api/v1/...` |
+
+> **Note:** The PC proxy (miloco-mcp-server) provides all gateway MCP tools plus additional extensions (camera P2P, Xiaomi auth, etc.).
+
+## Server Lifecycle
+
+| Action | macOS/Linux | Windows |
+|--------|-------------|---------|
+| Install | `bash scripts/install.sh` | `scripts\install.ps1` |
+| Setup | `bash scripts/setup.sh` | `scripts\setup.bat` |
+| Start | `bash scripts/start.sh` | `scripts\start.bat` |
+| Stop | `bash scripts/stop.sh` | `scripts\stop.bat` |
+| Verify | `bash scripts/verify.sh` | `scripts\verify.bat` |
+| Status | `bash scripts/health_check.sh` | `scripts\health_check.bat` |
+| Custom port | `bash scripts/start.sh --port 9090` | `scripts\start.bat --port 9090` |
+| Upgrade | `bash scripts/upgrade.sh` | `powershell -File scripts\upgrade.ps1` |
+| Check updates | `bash scripts/upgrade.sh --check` | `powershell -File scripts\upgrade.ps1 -Check` |
+
+### System Dependencies (Linux)
+
+```bash
+sudo apt-get install -y libfmt8 libmosquitto1 libyaml-cpp0.7
+ldd bin/miloco-mcp-server | grep "not found"  # verify
+```
+
+## Cross-Platform Tools
+
+Unified interfaces that 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) | `scenes[]` |
+| `scene/trigger` | `platform` (string), `sceneId` (string) | Trigger result |
+
+> **Parameter convention:** `device/specs` uses `deviceId` (camelCase); platform-specific tools (`xiaomi/*`, `tuya/*`, etc.) use `device_id` (snake_case).
+
+## Platform Skill Modules
+
+Detailed tool references are split into sub-skill files by platform. Load as needed:
+
+| Module | File | Covers |
+|--------|------|--------|
+| **Xiaomi** | [skills/xiaomi.md](skills/xiaomi.md) | MIOT device control, OAuth auth, camera P2P, XiaoAI speaker |
+| **Tuya** | [skills/tuya.md](skills/tuya.md) | DP property read/write, QR code auth |
+| **Midea** | [skills/midea.md](skills/midea.md) | AC/appliance control, account auth |
+| **eWeLink** | [skills/ewelink.md](skills/ewelink.md) | Sonoff/eWeLink switches, multi-channel |
+| **Automation** | [skills/automation.md](skills/automation.md) | Schedule, trigger engine, room, memory, skill system |
+| **Extension** | [skills/extension.md](skills/extension.md) | Serial, GPIO, Xiaozhi AI, license, config, stats |
+
+## License System
+
+- **Free edition**: Xiaomi platform only (device control, cameras, XiaoAI, MCP proxy)
+- **Licensed edition**: All platforms (Xiaomi + Tuya + Midea + eWeLink)
+- `tuya/set_property`, `midea/set_property`, `ewelink/set_property` return `license_required` on free edition
+- `get_properties` and all other tools work without license
+
+## Configuration
+
+`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
+  token_file: "data/auth_token.json"
+camera:
+  frame_interval: 500
+  buffer_max_size: 20
+  buffer_ttl: 300
+  jpeg_quality: 90
+tuya:
+  token_file: "data/tuya_token.json"
+midea:
+  token_file: "data/midea_token.json"
+ewelink:
+  token_file: "data/ewelink_token.json"
+xiaozhi:
+  endpoint: ""            # ws:// or wss:// (empty = disabled)
+```
+
+## Troubleshooting
+
+| Symptom | Fix |
+|---------|-----|
+| `connection refused` | Start server: `bash scripts/start.sh` |
+| `authorized: false` | Authorize via `xiaomi/auth_url` → `xiaomi/auth_callback` |
+| `cannot open shared object file` | `sudo apt-get install -y libfmt8 libmosquitto1 libyaml-cpp0.7` |
+| `Tool not found` | Check tool name (see `tools/list` output) |
+| `key 'device_id' not found` | Platform tools use `device_id`; cross-platform `device/specs` uses `deviceId` |
+| `license_required` error | Set license key via `license/set` tool |
+| Library load error | `ldd bin/miloco-mcp-server \| grep "not found"` |
+
+Full API reference: [FeyaGate_MCP_API.md](FeyaGate_MCP_API.md), [FeyaGate_HTTP_API.md](FeyaGate_HTTP_API.md)

feyagate_skill/data/camera_extra_info.yaml

@@ -0,0 +1,51 @@
+support_classes:
+  - camera
+extra_info:
+  chuangmi.camera.068ac1:
+    channel_count: 2
+    name: 小白智能户外摄像机Q2 双摄照明版
+    vendor: 上海创米科技
+  chuangmi.camera.111ac1:
+    channel_count: 2
+    name: 小白智能摄像机 A2双摄版
+    vendor: 上海创米科技
+  chuangmi.camera.72ac1:
+    channel_count: 2
+    name: 小米智能摄像机C300双摄版
+    vendor: 上海创米科技
+  isa.camera.cw501d:
+    channel_count: 2
+    name: 小米室外摄像机 4 双摄版
+    vendor: 天津华来科技有限公司
+  isa.camera.hlmax:
+    channel_count: 2
+    name: 小米室外摄像机CW500双摄版
+    vendor: 天津华来科技有限公司
+  mxiang.camera.c500ch:
+    channel_count: 2
+    name: 小米智能摄像机C500双摄版
+    vendor: 上海摩象网络科技有限公司
+  xiaomi.camera.082ac1:
+    channel_count: 2
+    name: 小米智能摄像机 4 双摄版
+    vendor: 小米
+  xiaomi.camera.083ac1:
+    channel_count: 1
+    name: 小米智能摄像机 4 变焦版
+    vendor: 小米
+blacklist:
+  - chuangmi.camera.ipc004b
+  - miir.camera.ir01
+  - mxiang.camera.mwc11
+  - isa.camera.hl5
+  - xiaovv.camera.xva3
+  - xzh.camera.camera
+  - cgzn.camera.camera
+  - isa.camera.virtual
+  - lumi.camera.aq1
+  - fimi.camera.c1b
+  - yunyi.camera.v1
+  - fimi.camera.c1
+  - chuangmi.camera.v4
+  - chuangmi.camera.ipc007b
+  - chuangmi.camera.ipc010

feyagate_skill/data/config.yaml.example

@@ -0,0 +1,17 @@
+server:
+  ws_port: 8765
+  http_port: 38080
+  bind_address: "0.0.0.0"
+  webui_dir: "webui"          # path to WebUI static files (empty = disabled)
+
+auth:
+  cloud_server: "cn"          # cn / de / sg / us / ru / i2
+  token_file: "data/auth_token.json"
+
+camera:
+  frame_interval: 500         # ms between JPEG captures
+  buffer_max_size: 20         # max frames per camera/channel
+  buffer_ttl: 300             # seconds before frames expire
+  reconnect_min: 3            # seconds, initial reconnect delay
+  reconnect_max: 1200         # seconds, max reconnect delay
+  jpeg_quality: 90            # JPEG encode quality (1-100)

feyagate_skill/data/skills/automation.md

@@ -0,0 +1,71 @@
+---
+name: feyagate-automation
+description: Automation tools for FeyaGate. Schedule tasks (timed device control), trigger engine (camera-based automation), room management, and memory/note system. Use when setting up scheduled actions, automated triggers, room organization, or persistent memory.
+---
+
+# Automation & Utility Tools
+
+## Schedule
+
+| Tool | Arguments | Returns |
+|------|-----------|---------|
+| `schedule/add` | `name`, `scheduledTime`, `toolName`, `toolArgs`, `repeat`, `repeatDays` (opt) | Task ID |
+| `schedule/list` | — | `tasks[]` |
+| `schedule/get` | `id` | Task detail |
+| `schedule/update` | `id` + fields to update | Update result |
+| `schedule/delete` | `id` | Delete result |
+| `schedule/cancel` | `id` | Cancel result |
+
+**Repeat types:** `none` / `daily` / `weekdays` / `weekends` / `weekly` / `custom_days`
+
+**Example:**
+```json
+{
+  "name": "schedule/add",
+  "arguments": {
+    "name": "睡前关灯",
+    "scheduledTime": "2026-05-16T23:00:00+08:00",
+    "toolName": "xiaomi/set_property",
+    "toolArgs": "{\"device_id\":\"xxx\",\"siid\":2,\"piid\":1,\"value\":false}",
+    "repeat": "daily"
+  }
+}
+```
+
+## Trigger Engine (PC proxy)
+
+| Tool | Arguments | Returns |
+|------|-----------|---------|
+| `trigger/create` | `name`, `cameras`, `condition`, `actions` | Rule ID |
+| `trigger/list` | — | `rules[]` |
+| `trigger/update` | `id`, fields to update | Update result |
+| `trigger/delete` | `id` | Delete result |
+| `trigger/toggle` | `id`, `enabled` | Toggle result |
+| `trigger/logs` | `limit`, `rule_id` (opt) | `logs[]` |
+
+## Room Management
+
+| Tool | Arguments | Returns |
+|------|-----------|---------|
+| `room/list` | — | Unique room name list |
+| `room/set_device` | `device_ids` (string[]), `room_name` (string) | Assignment result |
+
+## Memory System
+
+| Tool | Arguments | Returns |
+|------|-----------|---------|
+| `memory/read` | — | All long-term memories |
+| `memory/add` | `content`, `category` (opt) | Added entry |
+| `memory/update` | `id`, `content` | Update result |
+| `memory/delete` | `id` | Delete result |
+| `memory/search` | `keyword` | Matching entries |
+| `memory/note` | `content` | Add today's note |
+| `memory/today` | — | Today's notes |
+
+## Skill System
+
+| Tool | Arguments | Returns |
+|------|-----------|---------|
+| `skill/list` | — | Available skills |
+| `skill/read` | `id` | Skill content |
+| `skill/manage` | `action` (add/update/delete) + other fields | Manage result |