Skip to main content
Glama
README.md
# 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`) |

## Quick Start

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

# 2. Add to your MCP client config (Hermes Agent / Claude Code / Cursor)
```

```json
{
  "mcpServers": {
    "reel-ffmpeg": {
      "command": "python3",
      "args": ["/Users/dilpreetjaura/reel-ffmpeg-mcp/server.py"]
    }
  }
}
```

## Repository Structure

```text
.
├── 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`](LICENSE).