handbrakemcp

# handbrake-mcp

MCP server for professional video transcoding via HandBrakeCLI. Batch processing, watch folders, queue management, 50+ presets.

> Full reference: [llms-full.txt](llms-full.txt)

## Key Tools
- **Transcoding** — MP4, MKV, AVI, MOV, M4V output with 50+ presets
- **Batch processing** — queue management for multi-file transcoding
- **Watch folders** — auto-process new files on folder change
- **Progress tracking** — real-time job progress via SSE/FastAPI
- **Custom params** — pass arbitrary HandBrakeCLI arguments

## Ports
| Port | Service |
|------|---------|
| 10874 | Dashboard frontend (Vite) |
| 10875 | Dashboard API (FastAPI) / MCP HTTP |

## Quick Start
```bash
uv sync && uv run handbrake-mcp-stdio
```

## Docs
- [README](README.md)
- [CHANGELOG](CHANGELOG.md)
- [llms-full.txt](llms-full.txt)

## Config
- [pyproject.toml](pyproject.toml)
- [.env.example](.env.example)