Video Editor MCP Server
A powerful video editing MCP server that leverages FFmpeg to perform video editing operations through natural language commands.
Components
Tools
The server implements one main tool:
execute_ffmpeg
: Executes FFmpeg commands with progress tracking- Takes a command string as input
- Validates and executes FFmpeg operations
- Reports real-time progress during processing
- Handles errors and provides detailed feedback
- Supports all FFmpeg operations including:
- Trimming/cutting
- Merging videos
- Converting formats
- Adjusting speed
- Adding audio tracks
- Extracting audio
- Adding subtitles
- Basic filters (brightness, contrast, etc.)
Configuration
Prerequisites
- FFmpeg must be installed and accessible in your system PATH
- Python 3.9 or higher
- Required Python packages:
Installation
- Install FFmpeg if not already installed:
- Install the video editor package:
Claude Desktop Integration
Configure in your Claude Desktop config file:
On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
Development
Building and Publishing
- Sync dependencies:
- Build package:
- Publish to PyPI:
Note: Set PyPI credentials via:
- Token:
--token
orUV_PUBLISH_TOKEN
- Or username/password:
--username
/UV_PUBLISH_USERNAME
and--password
/UV_PUBLISH_PASSWORD
Debugging
For the best debugging experience, use the MCP Inspector:
Example Usage
Once connected to Claude Desktop, you can make natural language requests like:
- "Trim video.mp4 from 1:30 to 2:45"
- "Convert input.mp4 to WebM format"
- "Speed up video.mp4 by 2x"
- "Merge video1.mp4 and video2.mp4"
- "Extract audio from video.mp4"
- "Add subtitles.srt to video.mp4"
The server will:
- Parse your request
- Generate the appropriate FFmpeg command
- Execute it with progress tracking
- Provide feedback on completion
Error Handling
The server includes robust error handling for:
- Invalid input files
- Malformed FFmpeg commands
- Runtime execution errors
- Progress tracking issues
All errors are reported back to the client with detailed messages for debugging.
Security Considerations
- Only processes files in explicitly allowed directories
- Validates FFmpeg commands before execution
- Sanitizes all input parameters
- Reports detailed error messages for security-related issues
Contributing
Contributions are welcome! Please follow these steps:
- Fork the repository
- Create your feature branch
- Make your changes
- Submit a pull request
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
FFmpeg에서 제공하는 자연어 명령을 사용하여 비디오 편집이 가능하며, 실시간 진행 상황 추적 및 오류 처리를 통해 트리밍, 병합, 형식 변환 등의 작업을 지원합니다.
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityA lightweight server that exposes FFmpeg's video processing capabilities to AI assistants through the Model Context Protocol (MCP), supporting operations like video format conversion, audio extraction, and adding watermarks.Last updated 5 months ago852215MIT License
- AsecurityAlicenseAqualityAn MCP server providing video processing capabilities through FFmpeg, enabling dialog-based local video search, trimming, concatenation, and playback functionalities.Last updated 3 months ago873MIT License
- AsecurityAlicenseAqualityProvides powerful video and audio editing capabilities through FFmpeg, enabling AI assistants to perform professional-grade operations including format conversion, trimming, overlays, transitions, and advanced audio processing.Last updated 3 months ago2719MIT License
- -securityFlicense-qualityWeb-based video editing platform that provides direct editing functionality through a Model Context Protocol server, supporting media file management, timeline editing, and advanced transformation effects.Last updated 3 months ago4