mcp-ffmpeg

@bitscorp-mcp

About mcp-ffmpeg

mcp-ffmpeg: resize videos, extract audio.

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is mcp-ffmpeg?

mcp-ffmpeg is a Node.js server that uses FFmpeg to manipulate video files. It provides APIs to resize videos to different resolutions (360p, 480p, 720p, 1080p) and extract audio in MP3, AAC, WAV, and OGG formats. This server is designed for users who want to process videos through an MCP-compatible client, such as Claude Desktop.

How to use mcp-ffmpeg?

Install Node.js (v14+) and FFmpeg on your system. Clone the repository, run npm install, then start the server with npm start. Alternatively, run directly with npx /path/to/mcp-ffmpeg. For integration with Claude Desktop, add the server to your Claude Desktop config file under mcpServers using the npx command. Once configured, use natural language prompts like "resize the video at /path/to/video.mp4 to 720p resolution".

Key features of mcp-ffmpeg

Resize videos to 360p, 480p, 720p, 1080p
Extract audio in MP3, AAC, WAV, OGG
Temporary file storage in uploads and output directories
File upload size limit of 500 MB
Integrates with Claude Desktop for natural language control
Can be run via npx without global installation

Use cases of mcp-ffmpeg

Resize a video to a lower resolution for easier sharing or mobile playback
Extract audio from a video to create a podcast or music track
Automate video processing tasks by combining with other MCP tools
Enable non-technical users to process videos through an AI assistant

FAQ from mcp-ffmpeg

What are the prerequisites for running mcp-ffmpeg?

You need Node.js version 14 or higher and FFmpeg installed on your system.

How do I install FFmpeg?

On macOS, run brew install ffmpeg. On Ubuntu/Debian, run sudo apt update && sudo apt install ffmpeg. On Windows, download FFmpeg from the official website, extract it to a folder (e.g., C:\ffmpeg), and add the bin folder to your PATH.

How do I integrate mcp-ffmpeg with Claude Desktop?

Locate your Claude Desktop config file (macOS: ~/.config/claude-desktop/config.json, Windows: %APPDATA%\Claude Desktop\config.json, Linux: ~/.config/claude-desktop/config.json). Add the server under mcpServers with "command": "npx" and "args": ["--yes", "/absolute/path/to/mcp-ffmpeg"]. Restart Claude Desktop.

What is the maximum file size I can upload?

The server has a file size limit of 500 MB for uploads.

Where are the processed video and audio files stored?

Uploaded files are temporarily stored in the uploads directory, and processed files are saved in the output directory.

Frequently asked questions

What are the prerequisites for running mcp-ffmpeg?

You need Node.js version 14 or higher and FFmpeg installed on your system.

How do I install FFmpeg?

On macOS, run `brew install ffmpeg`. On Ubuntu/Debian, run `sudo apt update && sudo apt install ffmpeg`. On Windows, download FFmpeg from the official website, extract it to a folder (e.g., `C:\ffmpeg`), and add the `bin` folder to your PATH.

How do I integrate mcp-ffmpeg with Claude Desktop?

Locate your Claude Desktop config file (macOS: `~/.config/claude-desktop/config.json`, Windows: `%APPDATA%\Claude Desktop\config.json`, Linux: `~/.config/claude-desktop/config.json`). Add the server under `mcpServers` with `"command": "npx"` and `"args": ["--yes", "/absolute/path/to/mcp-ffmpeg"]`. Restart Claude Desktop.

What is the maximum file size I can upload?

The server has a file size limit of 500 MB for uploads.

Where are the processed video and audio files stored?

Uploaded files are temporarily stored in the `uploads` directory, and processed files are saved in the `output` directory.

Comments

Basic information

More Other MCP servers

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K