xtcmoment-mcp

# XTCMoment MCP Server [English](#english) | ## English An MCP (Model Context Protocol) server for querying and retrieving moments from xtc smartwatch devices via ADB. ### Features - **Real-time data fetching** — Pull moment database directly from device via ADB - **Image retrieval** — Download images from moment posts and return as viewable content - **Video frame extraction** — Download videos and extract frames as individual images using ffmpeg - **Comment queries** — Retrieve comments with user info and reply relationships - **Force refresh** — Trigger app data refresh before querying ### Tool List | Tool | Description | |------|-------------| | `fetch_moment_by_timescope` | Query moments within a time range (Unix ms timestamps) | | `fetch_latest_moment` | Get the latest 50 moments | | `force_refresh_moments` | Force-refresh the moment feed on device | | `get_images_by_moment_id` | Get images for a specific moment by momentId | | `get_video_as_images_by_moment_id` | Download a video and return its frames as images | | `get_comments_by_moment_id` | Get comments for a specific moment | ### Requirements - Python 3.10+ - Android device with xtc moment app installed, connected via ADB (with root/su access) - ffmpeg (for video frame extraction) ### Installation ```bash pip install -r requirements.txt ``` ### Usage ```bash python src/main.py ``` The server starts on stdio, ready to be used with any MCP-compatible client (e.g., Claude Desktop). ### Device Setup The server interacts with the device via ADB. Ensure: 1. ADB debugging is enabled on the device 2. Device is connected (`adb devices` shows it) 3. The device has `su` access for database extraction