FFmpeg MCP Server
Provides FFmpeg video processing capabilities via base64 I/O, including resize video, extract audio, and get video info.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
FFmpeg MCP Server
MCP server providing FFmpeg video processing via base64 I/O. Stateless, portable, zero external dependencies.
Tools
get_ffmpeg_version
Returns FFmpeg version information.
resize_video
Resize video to standard resolutions (360p, 480p, 720p, 1080p). Outputs H.264/AAC.
Parameters:
videoBase64(string): Base64 encoded videoresolutions(array): Target resolutionsoutputFormat(string, optional): mp4 or webm (default: mp4)
Returns: Base64 encoded video for each resolution
extract_audio
Extract audio track from video.
Parameters:
videoBase64(string): Base64 encoded videoformat(string): mp3, aac, wav, or ogg
Returns: Base64 encoded audio
get_video_info
Inspect video metadata: format, duration, bitrate, resolution, codecs, streams.
Parameters:
videoBase64(string): Base64 encoded video
Returns: Formatted metadata
Related MCP server: FFmpeg MCP Tool
Design
Base64 I/O: All inputs and outputs are base64 encoded. No file paths, S3 URLs, or database storage.
Why:
Stateless: No persistent storage, cleanup, or orphaned files
Portable: Works in any Node.js environment
Simple: Single request/response cycle
Constraints:
Payload limits: ~4-6 MB depending on runtime
Best for: Thumbnails, previews, short clips, audio extraction
Not for: Feature films, 4K processing
Processing flow:
Decode base64 input → temp file
Execute FFmpeg
Read output → buffer
Delete temp files
Encode buffer → base64
Installation
FFmpeg binaries install automatically via ffmpeg-static and @ffprobe-installer/ffprobe.
npm install @windsornguyen/ffmpeg-mcpConfiguration
Claude Desktop
claude_desktop_config.json:
{
"mcpServers": {
"ffmpeg": {
"command": "npx",
"args": ["-y", "@windsornguyen/ffmpeg-mcp"]
}
}
}VS Code
.vscode/mcp.json:
{
"servers": {
"ffmpeg": {
"command": "npx",
"args": ["-y", "@windsornguyen/ffmpeg-mcp"]
}
}
}Development
# Install dependencies
bun install
# Build
bun run build
# Test
bun test
# Run STDIO transport
bun run dev:stdio
# Run HTTP transport
bun run dev:shttpEnvironment Variables
PORT: HTTP server port (default: 3002)NODE_ENV: development | production
Testing
# Run all tests
bun test
# Run with output artifacts (kept in tests/output/)
bun test --keep-artifacts
# Single test file
bun test tests/ffmpeg.test.tsTests verify base64 round-trip encoding, resolution accuracy, and codec compliance. Output artifacts saved to tests/output/ when --keep-artifacts is set.
Architecture
Client (
src/client.ts): FFmpeg execution with base64 I/OTools (
src/tools/ffmpeg.ts): MCP tool definitionsServer (
src/server.ts): Request routingTransport (
src/transport/): STDIO and HTTP support
License
MIT License. See LICENSE file for details.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Convert, probe, and split video into frames — real FFmpeg, paid per job with x402 on Base.
Run FFmpeg and FFprobe in the cloud: convert, compress, trim and analyze video and audio.
FFmpeg processing for video, audio and images via MCP with OAuth and shared account allowance.
Transform video, audio and images, and generate media from prompts. FFmpeg, captions, models.
Related MCP Servers
- AlicenseBqualityDmaintenanceProvides powerful video and audio editing capabilities through FFmpeg, enabling AI assistants to perform professional-grade operations including format conversion, trimming, overlays, transitions, and advanced audio processing.2790MIT
- FlicenseNot gradedqualityDmaintenanceEnables image and video processing through FFmpeg, including compression, format conversion, resizing, and batch processing operations for common media formats.-
- AlicenseAqualityDmaintenanceEnables video and audio processing through FFmpeg, supporting format conversion, compression, trimming, audio extraction, frame extraction, video merging, and subtitle burning through natural language commands.8170 PyPI28MIT
- FlicenseAqualityDmaintenanceEnables comprehensive video and audio processing using FFmpeg, supporting tasks like metadata extraction, clipping, scaling, and adding transitions or overlays. It provides a high-performance interface for building media processing microservices via FastMCP.1212-