VE Video Style Transfer MCP

Async MCP server for video style redraw via ve-backend proxy.

Environment

• API_URL: backend proxy url, default https://api.visionengine-tech.com/api/v1/video-style-transfer
• API_KEY: user API key from VisionEngine backend (required for submit/query and remote upload)
• WORKDIR: local workspace root
• DEFAULT_OUTPUT_DIR: default relative output directory, default public/videos
• FILE_MODE: local file handling mode, local or remote, default remote
• REMOTION_WORK_DIR: shared mount root used in local mode, default /vec
• BASE_URL: backend public base url used for /save and /shared links, default https://api.visionengine-tech.com
• Remote upload path is built-in in code: public/videos (no env override)

Tools

• submit
• query

submit

Submit an async video style transfer task and receive a taskId for later polling.

The tool returns a friendly reminder such as:

• Video style transfer task submitted successfully. It may take a while to finish; please wait about 10 seconds before querying the result.

videoPath can be either:

• a public video URL, or
• a local file path.

When videoPath is a local file path:

• FILE_MODE=local: convert local absolute path to backend shared download URL by removing REMOTION_WORK_DIR prefix, then send URL to provider
• FILE_MODE=remote (default): upload local file to backend /save with API key (saved to built-in public/videos), then convert returned path to /shared/...?...download=true URL and send URL to provider

Input video limits (upstream API constraints):

• Duration must be <= 30 seconds
• File size must be <= 100MB
• Each side of resolution must be between 256 and 4096 pixels
• Aspect ratio (long side / short side) must be <= 1.8
• Supported formats: MP4, AVI, MKV, MOV, FLV, TS, MPG, MXF
• If URL contains non-ASCII characters (for example Chinese), URL-encode it first

query

Query a submitted task by taskId.

• If the task is still running, the tool returns the current taskStatus and suggests waiting about 10 seconds before querying again.
• If the task succeeds, the tool returns outputVideoUrl and, by default, downloads the final video locally.
• Set downloadResult=false if you only want to inspect task status or retrieve the remote result URL without downloading.

Typical flow:

1. Call submit
2. Wait around 10 seconds
3. Call query with the returned taskId
4. Repeat query until taskStatus becomes SUCCEEDED