FFmpeg MCP Server
io.github.Ashutos1997/ffmpeg-mcp-server·v0.5.0·2 starsFFmpeg & FFprobe media processing toolkit for video, audio, and social formats
2 stars402 downloads/wk
Reviews
Write oneNobody 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 postsRead from the package source without running it. The installed server may list more.
add_overlayPlace a watermark image, logo PNG, or branding graphic over a video with customizable position, padding, scaling, and opacity.
add_subtitlesEmbed an SRT or VTT subtitle track into a video container (mov_text for MP4, srt for MKV) without re-encoding the video stream.
burn_subtitlesHardcode/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_speedChange video and audio playback speed (such as 2x for fast forward or 0.5x for slow motion) with pitch correction.
compress_videoCompress 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_mediaJoin 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 actionCombine 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_audioExtract 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_keyframesExtract 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_thumbnailCapture 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_waveformGenerate a PNG waveform image from an audio or video file. Returns the file path and inlined base64 image data.
media_convertConvert 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_probeInspect audio and video files with ffprobe. Returns container metadata, stream details, codecs, resolution, bitrate, and duration as JSON.
normalize_audioNormalize 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_ratioChange video aspect ratio to 9:16 vertical, 1:1 square, or 4:5 portrait. Adds blurred video borders, solid padding, or center crops.
trim_mediaCut 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_silenceDetect 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
- 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
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
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.
Transloadit Media ProcessingProcess video, audio, images and documents with Transloadit Robots. Connect by URL with OAuth.not reviewedEstablishedA
RendobarTransform video, audio and images, and generate media from prompts. FFmpeg, captions, models.not reviewedGrowingA
KinocutGuardrailed video editing for AI agents: FFmpeg, captions, effects, Hyperframes, and receipts.not reviewedEstablishedB- AudioEdit, analyze and convert audio: loudness, spec checks, denoise, EQ, cuts, BPM, key. No ffmpeg.not reviewedEstablishedA
- KinocutGuardrailed video editing for AI agents: FFmpeg, captions, effects, Hyperframes, and receipts.not reviewedEstablishedB