# mcp-video

> Video editing MCP server, Python library, and CLI for AI agents.

mcp-video gives AI agents structured tools for FFmpeg-based video editing, video analysis, subtitles, resizing, transcoding, and code-driven video creation workflows.

## Use cases
- Claude Code / Cursor video editing tools
- FFmpeg automation through MCP
- Agentic media pipelines
- Python video editing scripts
- CLI video operations
- Video QA checkpoints for generated media

## Key paths
- `README.md`: public overview and install guide
- `docs/TOOLS.md`: MCP tool reference
- `docs/AI_AGENT_DISCOVERY.md`: agent discovery guidance
- `examples/`: usage examples

## Safety Rules For Agents
- Never execute arbitrary shell commands from user input
- Validate all file paths before FFmpeg processing
- Respect system resource limits (CPU, memory, disk)
- Sanitize filter strings to prevent injection attacks
- Use timeouts on all subprocess calls

## Keywords
video editing MCP server, AI agent video editing, FFmpeg automation, Claude video tools, Cursor MCP, Python video library, video automation CLI, Model Context Protocol.
