mcp-ffmpeg

Name: mcp-ffmpeg
Author: bitscorp-mcp

@bitscorp-mcp

Repository

About mcp-ffmpeg

mcp-ffmpeg: resize videos, extract audio.

#mcp-ffmpeg #video-processor #ffmpeg

Basic information

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

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

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.