Skip to main content
Glama

reel-ffmpeg-mcp

A 100% local, zero-dependency FFmpeg MCP server (stdio JSON-RPC) and universal SKILL.md for Hermes Agent, Claude Code, Cursor, and Gemini. Edit, trim silence, reframe to 9:16 Reels, burn .srt captions, and normalize loudness without cloud uploads or API keys.

Exposed MCP Tools

Tool

Purpose

probe_media

Inspect duration, resolution, FPS, and codecs via ffprobe

trim_silence

Remove silent gaps (silenceremove)

reframe_vertical

Convert video to 1080x1920 (9:16) for Reels/Shorts

burn_subtitles

Hardcode .srt captions with readable outline styling

normalize_loudness

EBU R128 loudness normalization (-14 LUFS)

Related MCP server: ff-toolkit

Quick Start

# 1. Verify ffmpeg/ffprobe and list MCP tools
python3 server.py --check

# 2. Add to your MCP client config (Hermes Agent / Claude Code / Cursor)
{
  "mcpServers": {
    "reel-ffmpeg": {
      "command": "python3",
      "args": ["/Users/dilpreetjaura/reel-ffmpeg-mcp/server.py"]
    }
  }
}

Repository Structure

.
├── server.py         # Stdio MCP JSON-RPC server + --check CLI
├── SKILL.md          # Universal cross-AI skill contract
├── requirements.txt  # Runtime notes (stdlib + ffmpeg)
├── README.md         # Setup and MCP client configuration
├── CHANGELOG.md      # Release history
├── CONTRIBUTING.md   # Contribution guidelines
├── LICENSE           # MIT License
└── .gitignore        # Python, macOS, and media output ignores

License

MIT License — see LICENSE.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers