MCP.Market

FFmpeg MCP Server

by Ashutos1997·io.github.Ashutos1997/ffmpeg-mcp-server·v0.5.0·2 stars

FFmpeg & FFprobe media processing toolkit for video, audio, and social formats

A92/100grade A
What users say
No reviews yet
Be the first
Safety scan
A92/100

full report

Adoption
Growing

2 stars402 downloads/wk

Reviews

Write one

Nobody has reviewed FFmpeg MCP Server yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

FFmpeg MCP Server tools (17, 1 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • add_overlay

    Place a watermark image, logo PNG, or branding graphic over a video with customizable position, padding, scaling, and opacity.

  • add_subtitles

    Embed an SRT or VTT subtitle track into a video container (mov_text for MP4, srt for MKV) without re-encoding the video stream.

  • burn_subtitles

    Hardcode/burn subtitles directly into video frames with customizable font size, colors, and positioning. Unlike soft subtitles, burned subtitles render on all platforms including TikTok, Instagram Reels, and YouTube Shorts.

  • change_speed

    Change video and audio playback speed (such as 2x for fast forward or 0.5x for slow motion) with pitch correction.

  • compress_video

    Compress video files to fit upload limits (such as GitHub PRs under 10MB or Discord under 25MB) using target file sizes or CRF quality levels. Does not modify the original file.

  • concat_media

    Join multiple video or audio files in order into a single file. Uses stream copy for matching files or re-encodes when formats differ.

  • create_split_screenwrite action

    Combine two video files into a split-screen video. Stacks clips vertically (1080x1920 for Reels and TikTok) or places them side-by-side. Supports audio mixing and subtitle embedding.

  • extract_audio

    Extract an audio track from a video file into a standalone audio file. Supports the 'whisper_wav' preset (16kHz mono WAV) for speech recognition models, plus MP3, AAC, FLAC, and stream copy.

  • extract_keyframes

    Extract multiple representative frames across a video's timeline. In 'montage' mode, merges frames into a single contact-sheet grid image and inlines base64 for vision models to inspect the whole video at once.

  • extract_thumbnail

    Capture a single still image from a video. Returns the saved image path and inlined base64 image data so vision models can inspect the frame.

  • generate_waveform

    Generate a PNG waveform image from an audio or video file. Returns the file path and inlined base64 image data.

  • media_convert

    Convert video and audio files between formats. Includes presets for web MP4 (H.264/AAC), WebM (VP9/Opus), and animated GIF. Supports hardware acceleration on Apple Silicon, NVIDIA, Intel, and AMD.

  • media_probe

    Inspect audio and video files with ffprobe. Returns container metadata, stream details, codecs, resolution, bitrate, and duration as JSON.

  • normalize_audio

    Normalize audio loudness using the broadcast standard EBU R128 (loudnorm). Supports -16 LUFS (podcasts/Reels), -14 LUFS (YouTube), and optional voice clarity enhancement (80Hz high-pass to remove mic rumble). Works on audio or video files.

  • reformat_aspect_ratio

    Change video aspect ratio to 9:16 vertical, 1:1 square, or 4:5 portrait. Adds blurred video borders, solid padding, or center crops.

  • trim_media

    Cut a segment from a video or audio file. Uses stream copy without re-encoding by default, or re-encodes when accurate cuts are needed.

  • trim_silence

    Detect and remove silent pauses from audio or video files. Preserves video & audio lip-sync in 'start_end' mode. Returns original duration and seconds saved.

Public scan report

scanner v0.1.10 · 2026-10-24 · same rubric, same numbers if you re-run it

no findings
  • Code scan21 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 1 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 92/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How FFmpeg MCP Server compares

Against every graded Media MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
92/100
higher than 85% of 1,240 Media servers
Tools
17
the typical Media server has 7
Tools that change things
6%
typical: 5%. Fewer write tools means less an agent can break
GitHub stars
2
more than 75% of 680 Media servers
Downloads a week
402
more than 86% of 335 Media servers with a package

What its tools let an agent do: 13 read · 4 create

Install FFmpeg MCP Server in Claude Code, Cursor or VS Code

Runs npx -y @ash_j1997/ffmpeg-mcp-server on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add ffmpeg-mcp-server -- npx -y @ash_j1997/ffmpeg-mcp-server
Add to Cursor

What the publisher says

From the FFmpeg MCP Server repository's README, as published. We do not edit it. Read it on GitHub

ffmpeg-mcp-server

A Model Context Protocol (MCP) server that gives AI tools access to FFmpeg and FFprobe to process video and audio locally.

Supports cross-platform GPU hardware encoding (Apple Silicon, NVIDIA NVENC, Intel QuickSync, AMD AMF), live progress updates via MCP progress tokens, instant cancellation via AbortSignal, and inlines image previews directly for multimodal vision models.

Why This Exists

When AI agents process media, they often hallucinate invalid flags, syntax errors, or incompatible pixel formats.

This server provides 17 typed tools using Zod schemas. The AI passes parameters (such as { inputPath: "video.mov", preset: "web_mp4" }), and the server runs the valid FFmpeg command locally with proper error handling, hardware acceleration, and progress notifications.

Key Features

  • Universal Hardware Acceleration: Automatically detects and leverages hardware encoders across macOS (VideoToolbox), Linux/Windows GPUs (NVIDIA NVENC, Intel QuickSync, AMD AMF, and VA-API) for 5x–20x faster exports with low CPU usage.
  • Real-time Progress Reporting: Emits live percentage updates via standard MCP progress tokens (notifications/progress), enabling progress bars in modern AI clients.
  • Instant Cancellation: Listens to client AbortSignal events to immediately terminate child FFmpeg processes when a generation is stopped.
  • Multimodal Vision Previews: Inlines base64 image data for thumbnails, audio waveforms, and multi-frame contact sheets so vision models (Claude 3.7, GPT-4o, Gemini) can "see" media content.
  • Social Formats & Automation: Reformats landscape video to 9:16 vertical video with blurred backgrounds, burns customizable hardcoded subtitles, and stacks top/bottom split-screen reels for TikTok and Instagram Reels.
  • Audio Engineering: Normalizes loudness to broadcast/streaming standards (EBU R128 / -16 LUFS), cleans vocal audio with 80Hz rumble removal, and trims dead air while preserving lip-sync.

Included Tools (17 Total)

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

FFmpeg MCP Server: common questions

Is FFmpeg MCP Server safe?
Yes, by our scan: it is graded A (92/100). Read the FFmpeg MCP Server safety report
How do I install FFmpeg MCP Server?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does FFmpeg MCP Server need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is FFmpeg MCP Server maintained?
The last commit was 2 days ago (2026-10-23). The latest release is v0.5.0.
What can I use instead of FFmpeg MCP Server?
Servers from other publishers that do the same job: Transloadit Media Processing MCP server, Rendobar MCP server and Kinocut MCP server. Compare all FFmpeg MCP Server alternatives.
How does FFmpeg MCP Server compare with other Media MCP servers?
safety score 92/100 (higher than 85% of 1,240 Media servers); tools 17 (the typical Media server has 7); tools that change things 6% (typical: 5%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to FFmpeg MCP Server

Same job from other publishers: the closest match first, then the best rated.

All FFmpeg MCP Server alternatives →
  • Transloadit Media Processing
    Process video, audio, images and documents with Transloadit Robots. Connect by URL with OAuth.
    A
  • Rendobar
    Transform video, audio and images, and generate media from prompts. FFmpeg, captions, models.
    A
  • Kinocut
    Guardrailed video editing for AI agents: FFmpeg, captions, effects, Hyperframes, and receipts.
    B
  • Audio
    Edit, analyze and convert audio: loudness, spec checks, denoise, EQ, cuts, BPM, key. No ffmpeg.
    A
  • Kinocut
    Guardrailed video editing for AI agents: FFmpeg, captions, effects, Hyperframes, and receipts.
    B