What is Media Utils Mcp

media-utils-mcp is an MCP Server designed to provide utilities for working with video and image files, enabling users to easily manage and manipulate multimedia content.

Use cases

Use cases for media-utils-mcp include converting video formats, extracting frames from videos, resizing images, and automating multimedia workflows in software applications.

How to use

To use media-utils-mcp, first ensure that FFMPEG is installed and accessible in your system path. You can run the development server by navigating to the ‘src’ directory and executing the command ‘uv run mcp dev media-utils-mcp.py’. For installation into Claude, use ‘uv run mcp install --with Pillow --with ffmpeg-python --with mcp media-utils-mcp.py’.

Key features

Key features of media-utils-mcp include integration with FFMPEG for video processing, support for image manipulation through the Pillow library, and a straightforward command-line interface for easy access to its functionalities.

Where to use

media-utils-mcp can be used in various fields such as video editing, image processing, multimedia content creation, and any application that requires handling and transforming video and image files.

Media Utils MCP

MCP Server that provides information on Images and Video files.

Requirements

FFMPEG

Download FFMPEG and make sure that it’s in your system path.

On MacOS you can run:

brew install ffmpeg

On Ubuntu/Debian:

sudo apt install ffmpeg

On Windows, use Chocolatey:

choco install ffmpeg

Installation

Install the required dependencies:

npm install @modelcontextprotocol/sdk sharp fluent-ffmpeg zod

To install into Claude desktop, add the following to the claude_desktop_config.json file.

    "media-utils": {
      "command": "npx",
      "args": [
        "-y",
        "node",
        "/Users/FOO/src/media-utils-mcp/src/media-utils-mcp.js",
        "--permitted",
        "/Users/FOO/Desktop/mcp"
      ]
    }

Usage

To run the server:

node src/media-utils-mcp.js --permitted /path/to/dir1 /path/to/dir2

The --permitted flag is used to specify which directories roots the MCP is allowed to access for security reasons.

Development

You can run in development using the MCP inspector:

npx @modelcontextprotocol/inspector node src/media-utils-mcp.js --permitted /Users/FOO/Desktop/mcp/

Features

This MCP provides tools for analyzing media files:

• getMediaInfo: Automatically detects whether files are images or videos and returns appropriate metadata

• getAllowedDirectories : List the directories the MCP has access to (specified in config)

• generateImagesFromVideos : Generates an image from each video, which is from a frame most representative of the content in the video.

Questions, Feature Requests, Feedback

If you have any questions, feature requests, need help, or just want to chat, join the discord.

You can also log bugs and feature requests on the issues page.

License

Project released under a MIT License.