Skip to main content
Glama

Video Editor MCP Server

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

  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
  2. 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
  2. Build package:
    uv build
  3. 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 MCP Inspector:

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

Example Usage

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

  1. "Trim video.mp4 from 1:30 to 2:45"
  2. "Convert input.mp4 to WebM format"
  3. "Speed up video.mp4 by 2x"
  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 it with progress tracking
  4. 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:

  1. Fork the repository
  2. Create your feature branch
  3. Make your changes
  4. Submit a pull request
-
security - not tested
F
license - not found
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

FFmpeg에서 제공하는 자연어 명령을 사용하여 비디오 편집이 가능하며, 실시간 진행 상황 추적 및 오류 처리를 통해 트리밍, 병합, 형식 변환 등의 작업을 지원합니다.

  1. 구성 요소
    1. 도구
  2. 구성
    1. 필수 조건
    2. 설치
    3. Claude 데스크톱 통합
  3. 개발
    1. 건축 및 출판
    2. 디버깅
    3. 사용 예
  4. 오류 처리
    1. 보안 고려 사항
      1. 기여하다

        Related MCP Servers

        • A
          security
          A
          license
          A
          quality
          A 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 ago
          8
          522
          15
          MIT License
        • A
          security
          A
          license
          A
          quality
          An MCP server providing video processing capabilities through FFmpeg, enabling dialog-based local video search, trimming, concatenation, and playback functionalities.
          Last updated 3 months ago
          8
          73
          MIT License
          • Apple
        • A
          security
          A
          license
          A
          quality
          Provides 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 ago
          27
          19
          MIT License
          • Apple
        • -
          security
          F
          license
          -
          quality
          Web-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 ago
          4

        View all related MCP servers

        MCP directory API

        We provide all the information about MCP servers via our MCP API.

        curl -X GET 'https://glama.ai/api/mcp/v1/servers/Kush36Agrawal/Video_Editor_MCP'

        If you have feedback or need assistance with the MCP directory API, please join our Discord server