FFmpeg-MCP

by video-creator

137 stars

361 downloads

Not rated

GitHub

Other

About

Using ffmpeg command line to achieve an mcp server, can be very convenient, through the dialogue to achieve the local video search, tailoring, stitching, playback,clip, overlay, concat and other functions

Details

Author: video-creator
GitHub stars: 137
Downloads: 361
Categories: Other

- Find video files in a directory recursively.
- Get video metadata (duration, fps, codec, dimensions).
- Trim video by start/end time or duration.
- Concatenate multiple videos with automatic smart mode.
- Play video or audio with ffplay.
- Overlay one video onto another at a specified position.
- Scale video dimensions while preserving aspect ratio.
- Extract frames from a video at a given rate (PNG, JPG, or WEBP).

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name FFmpeg-MCP

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "ffmpeg-mcp": {
            "ffmpeg-mcp": {
                "autoApprove": [],
                "disabled": false,
                "timeout": 60,
                "command": "uv",
                "args": [
                    "--directory",
                    "/Users/xxx/Downloads/ffmpeg-mcp",
                    "run",
                    "ffmpeg-mcp"
                ],
                "transportType": "stdio"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ffmpeg-mcp": {
            "ffmpeg-mcp": {
                "autoApprove": [],
                "disabled": false,
                "timeout": 60,
                "command": "uv",
                "args": [
                    "--directory",
                    "/Users/xxx/Downloads/ffmpeg-mcp",
                    "run",
                    "ffmpeg-mcp"
                ],
                "transportType": "stdio"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ffmpeg-mcp": {
            "ffmpeg-mcp": {
                "autoApprove": [],
                "disabled": false,
                "timeout": 60,
                "command": "uv",
                "args": [
                    "--directory",
                    "/Users/xxx/Downloads/ffmpeg-mcp",
                    "run",
                    "ffmpeg-mcp"
                ],
                "transportType": "stdio"
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "ffmpeg-mcp": {
            "ffmpeg-mcp": {
                "autoApprove": [],
                "disabled": false,
                "timeout": 60,
                "command": "uv",
                "args": [
                    "--directory",
                    "/Users/xxx/Downloads/ffmpeg-mcp",
                    "run",
                    "ffmpeg-mcp"
                ],
                "transportType": "stdio"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ffmpeg-mcp": {
            "ffmpeg-mcp": {
                "autoApprove": [],
                "disabled": false,
                "timeout": 60,
                "command": "uv",
                "args": [
                    "--directory",
                    "/Users/xxx/Downloads/ffmpeg-mcp",
                    "run",
                    "ffmpeg-mcp"
                ],
                "transportType": "stdio"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ffmpeg-mcp": {
            "ffmpeg-mcp": {
                "autoApprove": [],
                "disabled": false,
                "timeout": 60,
                "command": "uv",
                "args": [
                    "--directory",
                    "/Users/xxx/Downloads/ffmpeg-mcp",
                    "run",
                    "ffmpeg-mcp"
                ],
                "transportType": "stdio"
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "ffmpeg-mcp": {
            "ffmpeg-mcp": {
                "autoApprove": [],
                "disabled": false,
                "timeout": 60,
                "command": "uv",
                "args": [
                    "--directory",
                    "/Users/xxx/Downloads/ffmpeg-mcp",
                    "run",
                    "ffmpeg-mcp"
                ],
                "transportType": "stdio"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ffmpeg-mcp": {
            "ffmpeg-mcp": {
                "autoApprove": [],
                "disabled": false,
                "timeout": 60,
                "command": "uv",
                "args": [
                    "--directory",
                    "/Users/xxx/Downloads/ffmpeg-mcp",
                    "run",
                    "ffmpeg-mcp"
                ],
                "transportType": "stdio"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ffmpeg-mcp": {
            "ffmpeg-mcp": {
                "autoApprove": [],
                "disabled": false,
                "timeout": 60,
                "command": "uv",
                "args": [
                    "--directory",
                    "/Users/xxx/Downloads/ffmpeg-mcp",
                    "run",
                    "ffmpeg-mcp"
                ],
                "transportType": "stdio"
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "ffmpeg-mcp": {
            "ffmpeg-mcp": {
                "autoApprove": [],
                "disabled": false,
                "timeout": 60,
                "command": "uv",
                "args": [
                    "--directory",
                    "/Users/xxx/Downloads/ffmpeg-mcp",
                    "run",
                    "ffmpeg-mcp"
                ],
                "transportType": "stdio"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ffmpeg-mcp": {
            "ffmpeg-mcp": {
                "autoApprove": [],
                "disabled": false,
                "timeout": 60,
                "command": "uv",
                "args": [
                    "--directory",
                    "/Users/xxx/Downloads/ffmpeg-mcp",
                    "run",
                    "ffmpeg-mcp"
                ],
                "transportType": "stdio"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ffmpeg-mcp": {
            "ffmpeg-mcp": {
                "autoApprove": [],
                "disabled": false,
                "timeout": 60,
                "command": "uv",
                "args": [
                    "--directory",
                    "/Users/xxx/Downloads/ffmpeg-mcp",
                    "run",
                    "ffmpeg-mcp"
                ],
                "transportType": "stdio"
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "ffmpeg-mcp": {
            "ffmpeg-mcp": {
                "autoApprove": [],
                "disabled": false,
                "timeout": 60,
                "command": "uv",
                "args": [
                    "--directory",
                    "/Users/xxx/Downloads/ffmpeg-mcp",
                    "run",
                    "ffmpeg-mcp"
                ],
                "transportType": "stdio"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ffmpeg-mcp": {
            "ffmpeg-mcp": {
                "autoApprove": [],
                "disabled": false,
                "timeout": 60,
                "command": "uv",
                "args": [
                    "--directory",
                    "/Users/xxx/Downloads/ffmpeg-mcp",
                    "run",
                    "ffmpeg-mcp"
                ],
                "transportType": "stdio"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ffmpeg-mcp": {
            "ffmpeg-mcp": {
                "autoApprove": [],
                "disabled": false,
                "timeout": 60,
                "command": "uv",
                "args": [
                    "--directory",
                    "/Users/xxx/Downloads/ffmpeg-mcp",
                    "run",
                    "ffmpeg-mcp"
                ],
                "transportType": "stdio"
            }
        }
    }
}

From the repository

Clone the repository, run uv sync in the project directory, then configure your MCP client with the stdio transport. The client command is uv --directory /path/to/ffmpeg-mcp run ffmpeg-mcp. Tools are invoked automatically by the AI assistant when it processes natural language requests.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "ffmpeg-mcp": {
            "ffmpeg-mcp": {
                "autoApprove": [],
                "disabled": false,
                "timeout": 60,
                "command": "uv",
                "args": [
                    "--directory",
                    "/Users/xxx/Downloads/ffmpeg-mcp",
                    "run",
                    "ffmpeg-mcp"
                ],
                "transportType": "stdio"
            }
        }
    }
}

McpServers

{
    "ffmpeg-mcp": {
        "autoApprove": [],
        "disabled": false,
        "timeout": 60,
        "command": "uv",
        "args": [
            "--directory",
            "/Users/xxx/Downloads/ffmpeg-mcp",
            "run",
            "ffmpeg-mcp"
        ],
        "transportType": "stdio"
    }
}

FFmpeg-MCP

Using ffmpeg command line to achieve an mcp server, can be very convenient, through the dialogue to achieve the local video search, tailoring, stitching, playback and other functions

Support Tools

The server implements the following tools: - find_video_path The parameters are directory and file name, file name can be complete, or is not suffixed, recursive search in the directory, return the full path - get_video_info The parameters are video path, return the video info, linkes duration/fps/codec/width/height. - clip_video The parameter is the file path, start time, end time or duration, and returns the trimmed file path - concat_videos The parameters are the list of files, the output path, and if the video elements in the list of files, such as width, height, frame rate, etc., are consistent, quick mode synthesis is automatically used - play_video Play video/audio with ffplay, support many format, like mov/mp4/avi/mkv/3gp, video_path: video path speed: play rate loop: play count - overlay_video Two video overlay. background_video: backgroud video path overlay_video: front video path output_path: output video path position: relative location dx: x offset dy: y offset - scale_video Video scale. video_path: in video path width: out video width, -2 keep aspect height: out video height, -2 keep aspect output_path: output video path - extract_frames_from_video Extract images from a video. Parameters: video_path (str): The path to the video. fps (int): Extract one frame every specified number of seconds. If set to 0, extract all frames; if set to 1, extract one frame per second. output_folder (str): The directory where the images will be saved. format (int): The format of the extracted images; 0: PNG, 1: JPG, 2: WEBP. total_frames (int): The maximum number of frames to extract. If set to 0, there is no limit More features are coming

Installation procedure

1. Download project

git clone  https://github.com/video-creator/ffmpeg-mcp.git
cd ffmpeg-mcp
uv sync

2. Configuration in Cline

{

  "mcpServers": {

    "ffmpeg-mcp": {

      "autoApprove": [],

      "disabled": false,

      "timeout": 60,

      "command": "uv",

      "args": [

        "--directory",

        "/Users/xxx/Downloads/ffmpeg-mcp",

        "run",

        "ffmpeg-mcp"

      ],

      "transportType": "stdio"

    }

  }

}

Note: the value:/Users/XXX/Downloads/ffmpeg in args need to replace the actual download ffmpeg-mcp directory

Supported platforms

Currently, only macos platforms are supported, including ARM64 or x86_64

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

FFmpeg-MCP

Support Tools

Installation procedure

Supported platforms

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀