Home / MCP / FFmpeg MCP Server

FFmpeg MCP Server

MCP server that resizes videos and extracts audio using FFmpeg

javascript

43stars

View on GitHub

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
    "mcpServers": {
        "ffmpeg": {
            "command": "npx",
            "args": [
                "-y",
                "/absolute/path/to/mcp-ffmpeg"
            ]
        }
    }
}

You can process video files with this MCP server by resizing to common resolutions or extracting audio, all through simple MCP client requests. It uses FFmpeg under the hood to perform the actual processing, making it easy to integrate video transformations into your workflows and conversational prompts.

How to use

Use an MCP client to send requests that resize videos or extract audio. You can request a specific resolution such as 360p, 480p, 720p, or 1080p, and you can extract audio in formats like MP3, AAC, WAV, or OGG. Uploaded videos are stored temporarily, and the resulting files are saved in the output directory for you to retrieve.

How to install

Prerequisites you need before running the server:

Node.js version 14 or higher
FFmpeg installed and available in your system PATH

Install FFmpeg on your platform using one of the following commands:

# macOS
brew install ffmpeg

# Ubuntu / Debian
sudo apt update
sudo apt install ffmpeg

# Windows
# Download FFmpeg from the official site, extract to a folder (e.g., C:\\ffmpeg),
# then add the bin folder to your PATH

Install the MCP server dependencies and start the server with these steps:

# Step 1: Clone the project
git clone https://github.com/bitscorp-mcp/mcp-ffmpeg.git
cd mcp-ffmpeg

# Step 2: Install dependencies
npm install

# Step 3: Start the server
npm start

# Optional for development with auto-restart on changes
npm run dev

If you prefer to install via Smithery for Claude Desktop automation, run this command:

npx -y @smithery/cli install @bitscorp-mcp/mcp-ffmpeg --client claude

If you are configuring Cursor or another MCP client, you can also install the MCP server with Smithery using the following command:

npx -y @smithery/cli@latest run @bitscorp/mcp-ffmpeg

Available tools

resize_video

Resize an input video to a specified resolution (360p, 480p, 720p, 1080p) using FFmpeg. The server handles scaling and maintains video quality according to the target resolution.

extract_audio

Extract audio from a video into formats such as MP3, AAC, WAV, or OGG, returning a separate audio file.