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

Before using this server, make sure 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 FFmpeg official website
ImageMagick: Required for image processing operations
- macOS: brew install imagemagick
- Ubuntu/Debian: sudo apt-get install imagemagick
- Windows: Download from ImageMagick official website

How to use

Add this to your claude_desktop_config.json:

NPX

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

API

Tools

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 (default: "southeast")
  - 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 (blur, sharpen, edge, emboss, grayscale, sepia, negate)
  - 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. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.