MCP-FFmpeg: Effortless Video Resize & Audio Extraction

MCP-FFmpeg: Effortlessly resize videos and extract audio with powerful tools for fast, professional results.

Visit Repository

✨ Developer Tools

4.2(91 reviews)

136 saves

63 comments

Users create an average of 53 projects per month with this tool

About MCP-FFmpeg

What is MCP-FFmpeg: Effortless Video Resize & Audio Extraction?

MCP-FFmpeg is a streamlined Node.js server designed to simplify video and audio processing tasks. It leverages FFmpeg to offer intuitive APIs for resizing videos to common resolutions (360p–1080p) and extracting audio tracks in formats like MP3, AAC, WAV, and OGG. Ideal for developers and content creators, this tool provides a robust backend solution for media manipulation without requiring complex configurations.

How to Use MCP-FFmpeg: Effortless Video Resize & Audio Extraction?

Installation is straightforward:

Ensure Node.js (v14+) and FFmpeg are installed.
Clone the repository and install dependencies:

git clone https://github.com/yourusername/mcp-ffmpeg.git
cd mcp-ffmpeg
npm install

Start the server with npm start or use npm run dev for auto-reloading during development. Integrate with Claude Desktop by configuring its MCP server settings to point to your FFmpeg instance.

MCP-FFmpeg Features

Key Features of MCP-FFmpeg: Effortless Video Resize & Audio Extraction?

Resolution Flexibility: Scale videos to predefined presets (e.g., 720p for web streaming).
Format Agnosticism: Supports extraction of audio tracks into MP3, AAC, or lossless WAV formats.
Seamless Dev Workflow: Hot-reload mode accelerates iterative testing.
AI Integration: Compatible with Claude Desktop for voice-driven processing via natural language prompts.
Resource Management: Temporary uploads and processed outputs are stored in isolated directories with a 500MB upload cap.

Use Cases of MCP-FFmpeg: Effortless Video Resize & Audio Extraction?

Common scenarios include:

Platform Optimization: Resize videos to fit social media constraints (e.g., converting 1080p to 720p for Instagram).
Audio Extraction: Strip soundtracks from videos for podcasts or music libraries.
Cross-Device Adaptation: Generate multiple resolutions of a single video for devices with varying screen sizes.
Batch Processing: Automate media preparation workflows via API integrations.

MCP-FFmpeg FAQ

FAQ from MCP-FFmpeg: Effortless Video Resize & Audio Extraction?

Q: How do I troubleshoot FFmpeg installation issues?
Verify FFmpeg is added to your system PATH. On Windows, ensure the bin folder is correctly referenced. Use ffmpeg -version to confirm installation.

Q: Can I process files larger than 500MB?
The server enforces a 500MB limit to prevent resource exhaustion. Adjust the fileSizeLimit parameter in the config for larger files, but ensure your server can handle increased load.

Q: Why does audio extraction fail for some formats?
Check FFmpeg’s codec support. Install additional codecs via your OS package manager (e.g., apt install libavcodec-extra on Linux).

Q: Does the server support real-time progress updates?
Progress tracking is not built-in, but you can poll the output directory or extend the API with custom hooks for advanced use cases.

Content

MCP FFmpeg Video Processor

A Node.js server that uses FFmpeg to manipulate video files. This server provides APIs to:

Resize videos to different resolutions (360p, 480p, 720p, 1080p)
Extract audio from videos in various formats (MP3, AAC, WAV, OGG)

Prerequisites

Before running this application, you need to have the following installed:

Node.js (v14 or higher)
FFmpeg - This is required for video processing

Installing FFmpeg

On macOS:

bash brew install ffmpeg

On Ubuntu/Debian:

bash sudo apt update sudo apt install ffmpeg

On Windows:

Download FFmpeg from the official website
Extract the files to a folder (e.g., C:\ffmpeg)
Add the bin folder to your PATH environment variable

Installation

Clone this repository: bash git clone https://github.com/yourusername/mcp-ffmpeg.git cd mcp-ffmpeg
Install dependencies: bash npm install

Running the Server

Start the server with:

bash npm start

For development with auto-restart on file changes:

bash npm run dev

Using with Claude Desktop

This MCP FFmpeg server can be integrated with Claude Desktop to process videos through natural language requests.

Running with npx

You can run the server directly with npx:

bash npx /path/to/mcp-ffmpeg

Or if you've published the package to npm:

bash npx mcp-ffmpeg

Configuring Claude Desktop

To add this server to Claude Desktop, update your Claude Desktop configuration file:

Locate your Claude Desktop config file:

* macOS: `~/.config/claude-desktop/config.json` or `~/Library/Application Support/Claude Desktop/config.json`
* Windows: `%APPDATA%\Claude Desktop\config.json`
* Linux: `~/.config/claude-desktop/config.json`

Add the FFmpeg MCP server to the mcpServers section:

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

If you've published the package to npm:

json { "mcpServers": { "ffmpeg": { "command": "npx", "args": [ "--yes", "mcp-ffmpeg" ] } } }

Restart Claude Desktop for the changes to take effect.

Example Prompts for Claude

Once configured, you can use prompts like:

Using the ffmpeg MCP server, please resize the video at /path/to/video.mp4 to 720p resolution.

Notes

Uploaded videos are stored temporarily in the uploads directory
Processed videos and audio files are stored in the output directory
The server has a file size limit of 500MB for uploads

License

MIT