Video EditorSAFE

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

1. FFmpeg must be installed and accessible in your system PATH
2. Python 3.9 or higher
3. Required Python packages:

mcp
httpx

Installation

1. Install FFmpeg if not already installed:

# On macOS with Homebrew
brew install ffmpeg

# On Windows with Chocolatey
choco install ffmpeg

# On Ubuntu/Debian
sudo apt install ffmpeg

1. Install the video editor package:

uv add video-editor

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

{
"mcpServers": {
"video-editor": {
"command": "uv",
"args": ["run", "video-editor"]
}
}
}

Development

Building and Publishing

1. Sync dependencies:

uv sync

1. Build package:

uv build

1. Publish to PyPI:

uv publish

Note: Set PyPI credentials via:

• Token: --token or UV_PUBLISH_TOKEN
• Or username/password: --username/UV_PUBLISH_USERNAME and --password/UV_PUBLISH_PASSWORD

Debugging

For the best debugging experience, use the