image-processingvideo-processingmedialocalmcp
Local MCP server providing image and video processing tools without API keys or configuration.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
Automated check passed— started and listed 13 tools correctly (1mo ago).
Manual Client & Custom JSON ConfigExpand JSON ▾
Client Config & Setup
Choose your client or environment
Target File:
💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Overview
Use cases
Resize images to specific dimensions or scale factors
Convert images and videos between supported formats
Compress images to reduce file size with quality control
Extract video frames at regular intervals
Retrieve metadata and technical info from images and videos
Key features
Image resizing, cropping, rotating, flipping, and filtering
Image format conversion and compression with quality settings
Metadata extraction and stripping from images
Video info retrieval, frame extraction, and format conversion
No API keys or configuration required
Supports integration with multiple MCP-compatible clients
Capabilities & Tool Schemas (13)
Inspect callable tools, capabilities, and parameters exposed to AI agents by Media MCP.
get_image_infoGet detailed information about an image file. Returns dimensions, format, color mode, file size, and EXIF metadata.
resize_imageResize an image by dimensions or scale factor. Provide width/height, or a scale factor (e.g. 0.5 for half size). By default, aspect ratio is preserved. If only width or height is given, the other dimension is calculated automatically.
convert_imageConvert an image to a different format. Supported formats: PNG, JPEG, WebP, GIF, BMP, TIFF, ICO, AVIF.
compress_imageCompress an image to reduce file size. Optionally resize to max dimensions while compressing. Works best with JPEG and WebP. PNG files will be converted to optimized PNG.
crop_imageCrop an image to a specific region. Coordinates are in pixels from the top-left corner.
create_thumbnailCreate a square thumbnail from an image. The image is resized to fit within a square of the given size, preserving aspect ratio.
Documentation Overview
🎨 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 Desktop / Cursor / VS Code
Add to your MCP config:
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)
Using pip
With video support
Note: Video tools require
ffmpegto be installed on your system. Install it from ffmpeg.org or via your package manager:
🔧 Configuration
Config file locations
Claude Desktop
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Claude Code
```bash claude mcp add media-mcp -- uvx media-mcp-server ```Cursor
Settings → MCP Servers → Add:
VS Code
Add to .vscode/mcp.json:
🧪 Development
Test with MCP Inspector
📋 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.
Related MCP Servers
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks — not a rating.
GitHub stars
4
Stargazers on the source repository.
Last commit
5mo ago
Most recent push to the default branch.
Availability
100%
Our rolling endpoint + install checks that succeeded.
Install check
Passed
Our sandbox started it and listed its tools.
Tools exposed
13
Callable tools this server registers over MCP.
Directory activity
2 views
Config copies, upvotes, and views on AllMCPs.
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about Media MCP
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/adityaaery20-media-mcp)HTML Embed
<a href="https://allmcps.com/mcp/adityaaery20-media-mcp"><img src="https://allmcps.com/api/badge/adityaaery20-media-mcp?style=directory" alt="Media MCP on AllMCPs" /></a>Technical Specs & Signals
CategoryMultimedia Process
PricingFree
10/10 checks healthy over the last 32d
67Quality signal: Great · 67/100How this signal is calculated ▾
Server availability25/25
Verified ownership10/20
Documentation & tools30/30
Adoption & activity2/15
Community engagement0/10
A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Supply-chain signal
No high-severity advisories surfaced by our automated scan.
Critical 0High 0Medium 0Low 0
Scanned 23d ago via OSV.dev · media-mcp-server (PyPI)
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.
Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.