Video Editor (FFMpeg)

🚀 Video Editing MCP Server

A powerful Video Editing MCP Server that uses FFmpeg to perform video editing operations via natural language commands.

🚀 Quick Start

This Video Editing MCP Server is designed to execute video editing operations using FFmpeg through natural - language commands. It offers a wide range of video editing capabilities and is easy to set up and use.

✨ Features

Tools

The server implements a main tool:

• execute_ffmpeg: Executes FFmpeg commands with progress tracking
  • Accepts a command string as input
  • Validates and executes FFmpeg operations
  • Reports real - time processing progress
  • Handles errors and provides detailed feedback
  • Supports all FFmpeg operations, including:
    • Cropping/Trimming
    • Merging videos
    • Converting formats
    • Adjusting speed
    • Adding audio tracks
    • Extracting audio
    • Adding subtitles
    • Basic filters (brightness, contrast, etc.)

📦 Installation

Prerequisites

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

   mcp
   httpx
   

Installation Steps

1. Install FFmpeg if not already installed:

   # On macOS using Homebrew
   brew install ffmpeg
   
   # On Windows using Chocolatey
   choco install ffmpeg
   
   # On Ubuntu/Debian
   sudo apt install ffmpeg
   

2. Install the video editing package:

   uv add video - editor
   

Claude Desktop Integration

Configure in your Claude Desktop configuration 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"]
    }
  }
}

🔧 Technical Details

Build and Release

1. Synchronize dependencies:

   uv sync
   

2. Build the package:

   uv build
   

3. Publish to PyPI:

   uv publish
   

Note: Set PyPI credentials in the following ways:

• 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 MCP inspector:

npx @modelcontextprotocol/inspector uv --directory /path/to/video_editor run video - editor

💻 Usage Examples

Basic Usage

Once connected to Claude Desktop, you can make natural - language requests like these:

1. "Crop video.mp4 from 1:30 to 2:45"
2. "Convert input.mp4 to WebM format"
3. "Speed up video.mp4 by 2 times"
4. "Merge video1.mp4 and video2.mp4"
5. "Extract audio from video.mp4"
6. "Add subtitles.srt to video.mp4"

The server will:

1. Parse your request
2. Generate the appropriate FFmpeg command
3. Execute and track the progress
4. Provide feedback upon completion

📚 Documentation

Error Handling

The server includes powerful error - handling capabilities for:

• Invalid input files
• Malformed FFmpeg commands
• Runtime execution errors
• Progress tracking issues

All errors are reported in detail to the client for debugging.

Security Considerations

• Only process files in explicitly allowed directories.
• Validate the validity of FFmpeg commands before execution.
• Sanitize all input parameters.
• Report detailed security - related error messages.

🤝 Contribution

Contributions are welcome! Please follow these steps:

1. Fork this repository.
2. Create a new branch for your feature: git checkout -b feature/your - feature
3. Commit your changes: git commit -m 'Describe your modifications'
4. Push to the remote repository: git push origin feature/your - feature
5. Create a Pull Request.

Please ensure that you check the code format and documentation compliance before submitting.