reel-ffmpeg-mcp
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).
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues