xhs-video-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| XHS_BGM_DIR | No | 背景音乐目录。默认值取决于操作系统，同 XHS_OUTPUT_DIR。 | |
| XHS_OCR_PSM | No | OCR 分割模式。 | 4 |
| XHS_OCR_LANG | No | OCR 识别语言。 | chi_sim+eng |
| XHS_TEMP_DIR | No | 临时文件目录。默认值取决于操作系统，同 XHS_OUTPUT_DIR。 | |
| XHS_FFMPEG_BIN | No | FFmpeg 可执行文件的绝对路径。默认使用系统 PATH 中的 ffmpeg。 | |
| XHS_OUTPUT_DIR | No | 输出视频目录。默认值取决于操作系统：macOS 为 ~/Library/Application Support/xhs-video-mcp，Linux 为 ${XDG_DATA_HOME:-~/.local/share}/xhs-video-mcp，Windows 为 %LOCALAPPDATA%/xhs-video-mcp。 | |
| XHS_IMAGE_FORMAT | No | 图片格式，可选 'jpeg'、'webp'、'png' 或 'auto'。 | |
| XHS_TESSERACT_BIN | No | Tesseract 可执行文件的绝对路径。默认使用系统 PATH 中的 tesseract。 | |
| XHS_MIN_IMAGE_AREA | No | 回退解析时的最小图片面积。 | 350000 |
| XHS_IMAGE_SOURCE_MODE | No | 图片来源模式，可选 'ci' 或 'auto'。 | |
| XHS_MIN_IMAGE_SHORT_SIDE | No | 回退解析时的最小图片短边。 | 700 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| create_video_from_xhsA | Create a short video from a Xiaohongshu post. Downloads images from the XHS post, adds background music, and generates a vertical (9:16) video suitable for TikTok/Reels. Args: url: Xiaohongshu post URL (supports various formats including share links) bgm: BGM file name from bgm folder, or "random" to pick randomly. Set to "none" to create video without music. duration_per_image: How many seconds each image should be displayed (default: 3) style_prompt: Natural-language style instructions for image annotation. Example: 在第一张图里把"马云"蓝色高亮并红笔圈出来 Returns: A dict containing: - video_path: Full path to the generated video file - images_count: Number of images in the video - duration: Total video duration in seconds - bgm_used: Name of the BGM file used (or null if none) - title: Title of the original XHS post - style_report: Style parsing/OCR diagnostics (or null when not used) |
| list_bgm_filesA | List all available BGM files in the music folder. Returns: A dict containing: - bgm_files: List of available BGM file names - bgm_dir: Path to the BGM directory |
| get_video_configA | Get current video generation configuration. Returns: A dict with current settings for video resolution, fps, etc. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 3 tools
Each tool targets a distinct concern: creating a video, listing BGM assets, and reading configuration. There is no overlap between these three operations, so an agent can clearly tell them apart.
All tool names follow a consistent verb_noun pattern with snake_case (create_video_from_xhs, list_bgm_files, get_video_config). The naming is predictable and uniform.
With 3 tools, the server is tightly scoped to its purpose of generating videos from Xiaohongshu posts. Each tool is necessary and there are no redundant or extraneous entries.
The core workflow is covered: create a video, list available BGM, and inspect configuration. A minor gap is the lack of a setter for video configuration, but this does not prevent the main use case from working.