MCP Media Processing Server

The MCP Media Processing Server provides a Node.js-based interface that exposes powerful video and image processing operations through the MCP. It lets you perform conversions, compressions, trims, and various image effects by delegating work to a remote MCP client, enabling you to integrate media workflows into your applications with consistent, scalable endpoints.

How to use

You’ll run a local MCP client that connects to the media processing server to perform media operations. Typical usage patterns involve sending requests for video conversion, trimming, or image manipulations, and receiving the processed media as outputs. Use a client that supports MCP to call the available operations listed in the API and pass the required inputs (paths, formats, dimensions, and options). The server handles the heavy lifting by delegating tasks to the underlying processing tools.

Key capabilities you can leverage include converting videos to different formats, compressing videos, trimming clips, compressing and converting images, resizing and rotating images, applying effects, and adding watermarks. Each operation accepts concrete inputs such as file paths and target parameters, and returns or saves the resulting media to your chosen location. Use descriptive output file names to avoid overwriting originals.

To configure your client, point it at the MCP entry created for this server and invoke the desired operation by name (for example, convert-video, trim-video, or add-watermark) with the required inputs. Ensure you provide absolute paths for input and output files, and supply any optional parameters only when you need to customize the result.

How to install

Prerequisites you must have installed on your system before using the server are FFmpeg for video processing and ImageMagick for image processing.

Install FFmpeg on your platform

# macOS
brew install ffmpeg

# Ubuntu/Debian
sudo apt-get update
sudo apt-get install ffmpeg

# Windows
# Download and install from the FFmpeg official website

Install ImageMagick on your platform

# macOS
brew install imagemagick

# Ubuntu/Debian
sudo apt-get update
sudo apt-get install imagemagick

# Windows
# Download and install from the ImageMagick official website

Now you can run the MCP client command shown to start the media processing server. You do not need to install a local package if you prefer to run the command directly via npx.

Run the MCP server client command exactly as shown in the configuration snippet to start using the service.

Notes and configuration details

This server is designed to be invoked by an MCP client using a standard command pattern. The client calls the available operations such as video conversion, video compression, trimming, and image processing. For setup, you typically rely on a single local stdio configuration that uses a command like npx with the appropriate package and version.

Example capability names you can target from your client include execute-ffmpeg, convert-video, compress-video, trim-video, compress-image, convert-image, resize-image, rotate-image, add-watermark, and apply-effect. Each operation requires specific inputs such as inputPath, outputPath, and the corresponding operational parameters.

Available tools

execute-ffmpeg

Execute any FFmpeg command with custom options, enabling flexible video processing and transformation workflows.

convert-video

Convert video to a different format, controlling input, output path, and format options.

compress-video

Compress a video file to adjust quality and size, with optional custom output path and filename.

trim-video

Trim a video to a specified start time and duration, with optional output settings.

compress-image

Compress a PNG image using ImageMagick with a configurable quality level.

convert-image

Convert an image to a different format, with optional custom output path and filename.

resize-image

Resize an image to specified width and height, with optional aspect ratio preservation.

rotate-image

Rotate an image by a specified number of degrees.

add-watermark

Overlay a watermark image onto another image at a chosen position and opacity.

apply-effect

Apply visual effects to an image such as blur, sharpen, edge, emboss, grayscale, sepia, or negate with adjustable intensity.