About media-mcp-server
media-mcp-server is an MCP server in the Files category: 🎨 MCP server for image & video processing — resize, convert, compress, crop, extract metadata, and more. No API keys, no config, just tools.
Install
uvx media-mcp-serverpip install media-mcp-serverThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (10)
apply_filterApply blur, sharpen, grayscale, emboss, contour, and more
Parameters not published.
compress_imageOptimize file size with quality and max dimension controls
Parameters not published.
convert_imageConvert between PNG, JPEG, WebP, GIF, BMP, TIFF, ICO, AVIF
Parameters not published.
create_thumbnailGenerate thumbnails with size control
Parameters not published.
crop_imageCrop to specific pixel coordinates
Parameters not published.
flip_imageMirror horizontally or vertically
Parameters not published.
get_image_infoGet dimensions, format, color mode, file size, EXIF data
Parameters not published.
resize_imageResize by dimensions or scale factor with aspect ratio control
Parameters not published.
rotate_imageRotate by any angle with optional expansion
Parameters not published.
strip_metadataRemove all EXIF/metadata for privacy
Parameters not published.
Ask AI
Ask AI about media-mcp-server
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
🎨 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)
| 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
- 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"]
}
}
}
Settings → MCP Servers → Add:
{
"media-mcp": {
"command": "uvx",
"args": ["media-mcp-server"]
}
}
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.
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.