JianYing MCP Server

How to use

You connect your MCP client to the JianYing MCP Server and issue commands that manipulate drafts, tracks, and media elements. The server exposes a comprehensive set of functions to draft, layer video, audio, and text, apply animations and transitions, and export final JianYing project files for editing.

How to install

Prerequisites: you need the MCP runtime tool installed to run this server locally. Install the MCP runtime on your system, then follow the steps below.

Install the MCP runtime (uv) on your platform.

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" 
```
```bash
# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

Clone and set up the server

Clone the project repository, install dependencies through the MCP runtime, and synchronize the environment.

git clone https://github.com/your-username/jianying-mcp.git
cd jianying-mcp
uv sync

Configure your MCP client

Add the JianYing MCP server configuration to your MCP client to connect and run the server locally. Use the following example as a starting point.

{
  "mcpServers": {
    "jianying-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/your-path/jianying-mcp/jianyingdraft",
        "run",
        "server.py"
      ],
      "env": {
        "SAVE_PATH": "/your-path/draft",
        "OUTPUT_PATH": "/your-path/output"
      }
    }
  }
}

What you can do with the server

With the JianYing MCP Server you can draft new projects, manage tracks and media, add video/audio/text segments, apply animations, transitions, and filters, and export an editable JianYing project file.

Debugging and troubleshooting

When you need to debug, use the MCP Inspector to run and test the server in development mode.

uv run mcp dev jianyingdraft/server.py

Notes on server configuration and environment

Environment variables shown for run-time include SAVE_PATH for draft data storage and OUTPUT_PATH for exported JianYing draft files.

create_draft

Create a new video draft project with defined rules and metadata.

export_draft

Export the current draft to a JianYing editable project file.

create_track

Create video/audio/text tracks within a draft.

add_video_segment

Add a video segment from a local file or URL.

add_video_animation

Apply entrance/exit animations to video segments.

add_video_transition

Add transitions between video segments.

add_video_filter

Apply visual filters to video tracks.

add_video_mask

Apply masking effects to video content.

add_video_background_filling

Fill the background for video compositions.

add_video_keyframe

Create keyframe animations for video properties.

add_audio_segment

Add an audio segment from a local file or URL.

add_audio_effect

Apply audio effects like EQ, reverb, or distortion.

add_audio_fade

Add fade-in and fade-out to audio.

add_audio_keyframe

Create keyframe animations for audio properties.

add_text_segment

Add text segments to the video timeline.

add_text_animation

Animate text appearance on screen.

add_text_bubble

Add speech or thought bubbles to text.

add_text_effect

Apply visual effects to text.

parse_media_info

Parse and extract metadata from media files.

find_effects_by_type

Search for available effect resources by type.