English Français العربية

Media MCP

Community Media and design

Local image and video processing: resize, convert, compress, crop, thumbnails, metadata extraction, rotate, flip, filters and ffmpeg-based video operations.

Source code Documentation

Install

The installation steps are in the documentation below. Documentation

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. 🎨 media-mcp-server
  2. ⚡ Quick Start
  3. 🛠️ Tools
  4. 💬 Example Usage
  5. 📦 Installation
  6. 🔧 Configuration
  7. 🧪 Development
  8. 📋 Supported Formats
  9. 🗺️ Roadmap
  10. 📄 License
  11. 🤝 Contributing

🎨 media-mcp-server

MCP server for image & video processing. No API keys. No config. Just tools.

Give your AI assistant the power to resize, convert, compress, crop, filter, and analyze images and videos — all through Model Context Protocol.

Works with Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, and any MCP-compatible client.

⚡ Quick Start

Claude Code
claude mcp add media-mcp -- uvx media-mcp-server
Claude Desktop / Cursor / VS Code

Add to your MCP config:

{
  "mcpServers": {
    "media-mcp": {
      "command": "uvx",
      "args": ["media-mcp-server"]
    }
  }
}

That's it. No API keys, no accounts, no environment variables.

🛠️ Tools

Image Tools
ToolDescription
get_image_infoGet dimensions, format, color mode, file size, EXIF data
resize_imageResize by dimensions or scale factor with aspect ratio control
convert_imageConvert between PNG, JPEG, WebP, GIF, BMP, TIFF, ICO, AVIF
compress_imageOptimize file size with quality and max dimension controls
crop_imageCrop to specific pixel coordinates
create_thumbnailGenerate thumbnails with size control
strip_metadataRemove all EXIF/metadata for privacy
rotate_imageRotate by any angle with optional expansion
flip_imageMirror horizontally or vertically
apply_filterApply blur, sharpen, grayscale, emboss, contour, and more
Video Tools (requires ffmpeg)
ToolDescription
get_video_infoGet duration, resolution, codec, bitrate, FPS, audio info
extract_framesPull frames at regular intervals
convert_videoConvert between MP4, WebM, MOV, AVI, GIF, MKV

💬 Example Usage

Once connected, just ask your AI:

"Resize screenshot.png to 800px wide"

"Convert all the PNGs in this folder to WebP"

"Strip the EXIF data from photo.jpg for privacy"

"Compress this image to under 500KB"

"Extract a frame every 5 seconds from demo.mp4"

"What are the dimensions of banner.png?"

"Make a grayscale version of logo.png"

"Create a 128x128 thumbnail of product-photo.jpg"

📦 Installation

uvx media-mcp-server
Using pip
pip install media-mcp-server
With video support
pip install media-mcp-server[video]

Note: Video tools require ffmpeg to be installed on your system. Install it from ffmpeg.org or via your package manager:

# macOS
brew install ffmpeg

# Ubuntu/Debian
sudo apt install ffmpeg

# Windows (with Chocolatey)
choco install ffmpeg

🔧 Configuration

Config file locations

Claude Desktop

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json json { "mcpServers": { "media-mcp": { "command": "uvx", "args": ["media-mcp-server"] } } }

Claude Code

claude mcp add media-mcp -- uvx media-mcp-server

Cursor

Settings → MCP Servers → Add:

{
  "media-mcp": {
    "command": "uvx",
    "args": ["media-mcp-server"]
  }
}

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "media-mcp": {
      "command": "uvx",
      "args": ["media-mcp-server"]
    }
  }
}

🧪 Development

git clone https://github.com/Adityaaery20/media-mcp.git
cd media-mcp
pip install -e ".[dev]"
pytest
Test with MCP Inspector
npx @modelcontextprotocol/inspector uvx media-mcp-server

📋 Supported Formats

Images: PNG, JPEG, WebP, GIF, BMP, TIFF, ICO, AVIF

Videos: MP4, WebM, MOV, AVI, GIF, MKV (requires ffmpeg)

🗺️ Roadmap

  • [ ] Batch operations (process entire directories)
  • [ ] Image watermarking
  • [ ] PDF to image conversion
  • [ ] OCR (text extraction from images)
  • [ ] Audio extraction from video
  • [ ] Image collage/montage creation
  • [ ] Smart crop (content-aware)
  • [ ] SVG rasterization

📄 License

MIT — do whatever you want with it.

🤝 Contributing

Contributions welcome! Please open an issue first to discuss what you'd like to add.

Built with FastMCP and Pillow

Frequently asked questions

What is Media MCP?

Local image and video processing: resize, convert, compress, crop, thumbnails, metadata extraction, rotate, flip, filters and ffmpeg-based video operations.

How do I install Media MCP?

Follow the installation steps in its documentation, shown on this page and in its repository.

Is Media MCP open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Media MCP?

It is published by Adityaaery20. AI.tn lists it but does not maintain or endorse it.

From the community awesome-mcp-servers lists and the project's GitHub repository. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.