Skip to main content
Glama
MCP Media Processing Server

MCP Media Processing Server

by maoxiaoke

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

Related MCP server: MCP FFmpeg Video Processor

Prerequisites

Before using this server, make sure you have the following dependencies installed on your system:

  • FFmpeg: Required for video processing operations

  • ImageMagick: Required for image processing operations

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.

Available Tools

10 tools
add-watermarkC

Add watermark to image

Inputs: inputPath (required), watermarkPath (required), opacity, outputFilename, +2 more.

apply-effectC

Apply visual effect to image

Inputs: effect (required), inputPath (required), intensity, outputFilename, +1 more.

compress-imageC

Compress PNG image using ImageMagick

Inputs: inputPath (required), outputFilename, outputPath, quality.

compress-videoC

Compress video file

Inputs: inputPath (required), outputFilename, outputPath, quality.

convert-imageC

Convert image to different format

Inputs: inputPath (required), outputFormat (required), outputFilename, outputPath.

convert-videoC

Convert video to different format

Inputs: inputPath (required), outputFormat (required), outputFilename, outputPath.

execute-ffmpegC

Execute any FFmpeg command with custom options

Inputs: inputPath (required), options (required), outputFilename, outputPath.

resize-imageC

Resize image to specified dimensions

Inputs: inputPath (required), height, maintainAspectRatio, outputFilename, +2 more.

rotate-imageC

Rotate image by specified degrees

Inputs: degrees (required), inputPath (required), outputFilename, outputPath.

trim-videoC

Trim video to specified duration

Inputs: duration (required), inputPath (required), startTime (required), outputFilename, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 10 tools

    Disambiguation4/5

    Most tools have distinct purposes targeting specific media processing tasks like compression, conversion, resizing, and watermarking. However, 'apply-effect' is somewhat ambiguous and could overlap with other image manipulation tools like 'add-watermark' or 'rotate-image', potentially causing confusion in tool selection.

    Naming Consistency5/5

    All tools follow a consistent verb-noun pattern with hyphenated naming (e.g., 'compress-image', 'convert-video', 'resize-image'). This uniformity makes the tool set predictable and easy to navigate, with no deviations in style or convention.

    Tool Count5/5

    With 10 tools, the server is well-scoped for media processing, covering common operations for images and videos. Each tool serves a clear purpose without redundancy, making the count appropriate for the domain and not overwhelming for agents.

    Completeness4/5

    The tool set provides good coverage for core media processing tasks, including compression, conversion, resizing, and trimming. However, there are minor gaps, such as no explicit tools for audio processing or metadata handling, which could limit some workflows but are not critical for basic operations.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A comprehensive Model Context Protocol server that provides advanced Node.js development tooling for automating project creation, component generation, package management, and documentation with AI-powered assistance.
      7
      9
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that enables AI assistants to perform comprehensive video and audio editing operations including trimming, effects, overlays, audio processing, and YouTube downloads.
      39 PyPI
      30
      MIT