FFmpeg

Provides media manipulation capabilities powered by FFmpeg via an MCP server to cut, convert, and process video and audio.

typescript

2

GitHub Stars

typescript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "pedromarianoalmeida-ffmpeg-mcp": {
      "command": "npx",
      "args": [
        "ffmpeg-mcp-server"
      ],
      "env": {
        "NONE": "<NONE>"
      }
    }
  }
}

FFmpeg MCP Server provides media manipulation capabilities powered by FFmpeg through a Model Context Protocol server. It enables you to perform tasks like cutting videos, converting formats, removing silence, and other advanced operations directly via MCP clients, without needing a separate FFmpeg installation on your system.

How to use

You connect an MCP client to the FFmpeg MCP Server to access its media tools. The server offers a set of actions you can call by describing the task you want to perform, such as extracting a video segment, converting formats, or removing silent portions from audio tracks. You can combine simple requests for common tasks or use the raw FFmpeg command tool for advanced operations if your use case requires full control.

How to install

Prerequisites you need on your machine: Node.js and npm (Node.js should be installed and available on your command line). You will also require a runtime environment capable of executing MCP-related commands as described below.

Install the FFmpeg MCP Server package globally using the following command.

npm install -g ffmpeg-mcp-server

Alternatively, you can run the server directly through a package runner if you prefer not to install globally. The recommended approach is to install the package globally and then start using it in your workflows.

Additional sections

Configuration notes: The FFmpeg MCP Server is self-contained and includes a bundled FFmpeg binary via a static distribution, so you do not need a separate system-wide FFmpeg installation.

Usage patterns include common media operations such as cutting video segments, converting between formats, and removing silence, as well as more advanced operations using a raw FFmpeg command path when you need full command-level control.

Development tips: If you are contributing or building from source, you will typically clone the repository, install dependencies, and build the project before running. The project structure places core logic in separate source files responsible for MCP setup and FFmpeg operations.

Notes on tools: The server exposes a set of tools designed for media manipulation, including cut_video, image_to_video, concat_videos, convert, remove_silence, and ffmpeg_raw. Each tool has a specific purpose and can be used via natural language prompts to perform the corresponding operation.

Available tools

cut_video

Extract a specific segment from a video using a start time and duration.

image_to_video

Create a video from a static image with a defined duration.

concat_videos

Join multiple videos into a single video file in sequence.

convert

Convert between media formats; the tool auto-detects formats from file extensions.

remove_silence

Detect and remove silent segments from the audio track or video.

ffmpeg_raw

Execute raw FFmpeg commands for advanced, command-level operations.