📌Overview

Purpose: To provide a Node.js server that implements the Model Context Protocol for powerful media processing operations, including video and image manipulation.

Overview: The MCP Media Processing Server delivers robust capabilities for handling various media processing tasks, allowing users to efficiently manipulate videos and images using FFmpeg and ImageMagick. This framework supports a wide range of operations conducive to enhancing media quality and compatibility.

Key Features:

• Video Processing and Conversion: Facilitates conversion between different video formats, along with trimming and editing functionalities to tailor videos as per requirements.

• Image Processing and Manipulation: Offers multiple options for image editing, including resizing, rotating, adding effects, and watermarking, enhancing the usability and aesthetics of image assets.

---

MCP Media Processing Server

A Node.js server implementing Model Context Protocol (MCP) for media processing operations, providing powerful video and image manipulation capabilities.

Features

• Video processing and conversion
• Image processing and manipulation
• Media compression
• Video trimming and editing
• Image effects and watermarking

Prerequisites

Ensure you have the following dependencies installed on your system:

• FFmpeg: Required for video processing operations

  • macOS: brew install ffmpeg
  • Ubuntu/Debian: sudo apt-get install ffmpeg
  • Windows: Download from the FFmpeg official website

• ImageMagick: Required for image processing operations

  • macOS: brew install imagemagick
  • Ubuntu/Debian: sudo apt-get install imagemagick
  • Windows: Download from the ImageMagick official website

How to Use

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "mediaProcessor": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-media-processor@latest"
      ]
    }
  }
}

API

Video Operations

• execute-ffmpeg

  • Execute any FFmpeg command with custom options
  • Inputs:
    • inputPath (string): Absolute path to input video file
    • options (string[]): Array of FFmpeg command options
    • outputPath (string, optional): Absolute path for output file
    • outputFilename (string, optional): Output filename

• convert-video

  • Convert video to different format
  • Inputs:
    • inputPath (string): Absolute path to input video file
    • outputFormat (string): Desired output format (e.g., mp4, mkv, avi)
    • outputPath (string, optional): Custom output path
    • outputFilename (string, optional): Custom output filename

• compress-video

  • Compress video file
  • Inputs:
    • inputPath (string): Absolute path to input video file
    • quality (number, optional): Compression quality (1-51, lower is better quality)
    • outputPath (string, optional): Custom output path
    • outputFilename (string, optional): Custom output filename

• trim-video

  • Trim video to specified duration
  • Inputs:
    • inputPath (string): Absolute path to input video file
    • startTime (string): Start time in format HH:MM:SS
    • duration (string): Duration in format HH:MM:SS
    • outputPath (string, optional): Custom output path
    • outputFilename (string, optional): Custom output filename

Image Operations

• compress-image

  • Compress PNG image using ImageMagick
  • Inputs:
    • inputPath (string): Absolute path to input PNG image
    • quality (number, optional): Compression quality (1-100)
    • outputPath (string, optional): Custom output path
    • outputFilename (string, optional): Custom output filename

• convert-image

  • Convert image to different format
  • Inputs:
    • inputPath (string): Absolute path to input image file
    • outputFormat (string): Desired output format (e.g., jpg, png, webp, gif)
    • outputPath (string, optional): Custom output path
    • outputFilename (string, optional): Custom output filename

• resize-image

  • Resize image to specified dimensions
  • Inputs:
    • inputPath (string): Absolute path to input image file
    • width (number, optional): Target width in pixels
    • height (number, optional): Target height in pixels
    • maintainAspectRatio (boolean, optional): Whether to maintain aspect ratio
    • outputPath (string, optional): Custom output path
    • outputFilename (string, optional): Custom output filename

• rotate-image

  • Rotate image by specified degrees
  • Inputs:
    • inputPath (string): Absolute path to input image file
    • degrees (number): Rotation angle in degrees
    • outputPath (string, optional): Custom output path
    • outputFilename (string, optional): Custom output filename

• add-watermark

  • Add watermark to image
  • Inputs:
    • inputPath (string): Absolute path to input image file
    • watermarkPath (string): Absolute path to watermark image file
    • position (string, optional): Position of watermark
    • opacity (number, optional): Watermark opacity (0-100)
    • outputPath (string, optional): Custom output path
    • outputFilename (string, optional): Custom output filename

• apply-effect

  • Apply visual effect to image
  • Inputs:
    • inputPath (string): Absolute path to input image file
    • effect (string): Effect to apply (e.g., blur, sharpen, edge, emboss)
    • intensity (number, optional): Effect intensity (0-100)
    • outputPath (string, optional): Custom output path
    • outputFilename (string, optional): Custom output filename

License

This MCP server is licensed under the MIT License, allowing you to use, modify, and distribute the software under its terms. For more details, refer to the LICENSE file in the project repository.