MCP server for image & video processing. No API keys. No config. Just tools.
๐จ 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
| Tool | Description |
|---|---|
get_image_info |
Get dimensions, format, color mode, file size, EXIF data |
resize_image |
Resize by dimensions or scale factor with aspect ratio control |
convert_image |
Convert between PNG, JPEG, WebP, GIF, BMP, TIFF, ICO, AVIF |
compress_image |
Optimize file size with quality and max dimension controls |
crop_image |
Crop to specific pixel coordinates |
create_thumbnail |
Generate thumbnails with size control |
strip_metadata |
Remove all EXIF/metadata for privacy |
rotate_image |
Rotate by any angle with optional expansion |
flip_image |
Mirror horizontally or vertically |
apply_filter |
Apply blur, sharpen, grayscale, emboss, contour, and more |
Video Tools (requires [ffmpeg](https://ffmpeg.org/download.html))
| Tool | Description |
|---|---|
get_video_info |
Get duration, resolution, codec, bitrate, FPS, audio info |
extract_frames |
Pull frames at regular intervals |
convert_video |
Convert 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
Using uvx (recommended โ zero install)
uvx media-mcp-server
Using pip
pip install media-mcp-server
With video support
pip install media-mcp-server[video]
Note: Video tools require
ffmpegto 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
{
"mcpServers": {
"media-mcp": {
"command": "uvx",
"args": ["media-mcp-server"]
}
}
}
Claude Code
```bash 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.
Tools (13)
get_image_infoGet dimensions, format, color mode, file size, EXIF dataresize_imageResize by dimensions or scale factor with aspect ratio controlconvert_imageConvert between PNG, JPEG, WebP, GIF, BMP, TIFF, ICO, AVIFcompress_imageOptimize file size with quality and max dimension controlscrop_imageCrop to specific pixel coordinatescreate_thumbnailGenerate thumbnails with size controlstrip_metadataRemove all EXIF/metadata for privacyrotate_imageRotate by any angle with optional expansionflip_imageMirror horizontally or verticallyapply_filterApply blur, sharpen, grayscale, emboss, contour, and moreget_video_infoGet duration, resolution, codec, bitrate, FPS, audio infoextract_framesPull frames at regular intervalsconvert_videoConvert between MP4, WebM, MOV, AVI, GIF, MKVConfiguration
{"mcpServers": {"media-mcp": {"command": "uvx", "args": ["media-mcp-server"]}}}