FFmpeg MCP Lite

FFmpeg MCP Lite requires the FFmpeg binary to be installed independently. Install it using your system's package manager.

# macOS
brew install ffmpeg

# Windows
winget install FFmpeg

# Ubuntu/Debian
sudo apt install ffmpeg

Install ffmpeg-mcp-lite from PyPI using pip or uv. Using uv provides isolated environments and faster installs.

pip install ffmpeg-mcp-lite
# or
uv pip install ffmpeg-mcp-lite

Register the server in your MCP client config using uvx to run the package in an isolated environment. Set FFMPEG_OUTPUT_DIR to control where processed files are saved.

{
  "mcpServers": {
    "ffmpeg": {
      "command": "uvx",
      "args": ["ffmpeg-mcp-lite"],
      "env": {
        "FFMPEG_OUTPUT_DIR": "/Users/you/Downloads"
      }
    }
  }
}

If your FFmpeg installation is in a non-standard location, configure the FFMPEG_PATH and FFPROBE_PATH environment variables to point to the exact binaries.

{
  "mcpServers": {
    "ffmpeg": {
      "command": "uvx",
      "args": ["ffmpeg-mcp-lite"],
      "env": {
        "FFMPEG_PATH": "/usr/local/bin/ffmpeg",
        "FFPROBE_PATH": "/usr/local/bin/ffprobe",
        "FFMPEG_OUTPUT_DIR": "/tmp/output"
      }
    }
  }
}

The server provides: ffmpeg_get_info (inspect media properties via ffprobe), ffmpeg_convert (change format or codec), ffmpeg_compress (reduce file size), ffmpeg_trim (cut a time segment), ffmpeg_extract_audio (pull audio track), ffmpeg_extract_frames (grab still images), ffmpeg_merge (join multiple videos), and ffmpeg_add_subtitles (burn in subtitles from an SRT file).