XTCMoment MCP Server

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

Tools

| 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

pip install -r requirements.txt

Usage

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:

ADB debugging is enabled on the device
Device is connected (adb devices shows it)
The device has su access for database extraction

Chinese

一个基于 MCP（模型上下文协议）的服务器，通过 ADB 从 xtc 智能手表设备实时拉取和查询好友圈动态数据。

功能

实时数据拉取 — 通过 ADB 直接从设备拉取数据库
图片获取 — 下载动态中的图片并以可视内容返回
视频逐帧提取 — 下载视频并使用 ffmpeg 逐帧提取为图片
评论查询 — 获取评论列表，含评论人信息及回复关系
强制刷新 — 查询前主动刷新设备端数据

工具列表

| 工具 | 说明 | |------|------| | fetch_moment_by_timescope | 按时间范围查询好友圈动态（Unix 毫秒时间戳） | | fetch_latest_moment | 获取最新的 50 条动态 | | force_refresh_moments | 强制刷新设备上的好友圈数据 | | get_images_by_moment_id | 根据动态 ID 获取图片列表 | | get_video_as_images_by_moment_id | 下载视频并逐帧提取为图片返回 | | get_comments_by_moment_id | 根据动态 ID 获取评论列表 |

环境要求

Python 3.10+
已安装 xtc 好友圈应用的 Android 设备，通过 ADB 连接（需要 root/su 权限）
ffmpeg（用于视频帧提取）

安装

pip install -r requirements.txt

运行

python src/main.py

服务器通过 stdio 启动，可与任何兼容 MCP 的客户端配合使用（如 Claude Desktop）。

设备配置

服务器通过 ADB 与设备通信。请确保：

设备已启用 ADB 调试
设备已连接（adb devices 可看到）
设备拥有 su 权限（用于提取数据库）

MCP Servers