media-mcp

Get detailed information about an image file.

Returns dimensions, format, color mode, file size, and EXIF metadata.

Args: path: Absolute path to the image file.

Resize 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.

Args: path: Absolute path to the image file. width: Target width in pixels. height: Target height in pixels. scale: Scale factor (e.g. 0.5 = half, 2.0 = double). keep_aspect_ratio: Preserve aspect ratio when both width and height given. output_path: Where to save. Defaults to _resized. next to input.

Convert an image to a different format.

Supported formats: PNG, JPEG, WebP, GIF, BMP, TIFF, ICO, AVIF.

Args: path: Absolute path to the image file. format: Target format (e.g. 'png', 'webp', 'jpeg'). output_path: Where to save. Defaults to .<new_ext> next to input. quality: Quality for lossy formats (1-100). Default 85.

Compress 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.

Args: path: Absolute path to the image file. quality: Compression quality (1-100, lower = smaller file). Default 60. max_width: Optional maximum width. Image will be downscaled if wider. max_height: Optional maximum height. Image will be downscaled if taller. output_path: Where to save. Defaults to _compressed..

Crop an image to a specific region.

Coordinates are in pixels from the top-left corner.

Args: path: Absolute path to the image file. left: Left edge x coordinate. top: Top edge y coordinate. right: Right edge x coordinate. bottom: Bottom edge y coordinate. output_path: Where to save. Defaults to _cropped..

Create a square thumbnail from an image.

The image is resized to fit within a square of the given size, preserving aspect ratio.

Args: path: Absolute path to the image file. size: Thumbnail size in pixels (default 256). Creates a size x size bounding box. output_path: Where to save. Defaults to _thumb..

Remove all EXIF and metadata from an image for privacy.

Creates a clean copy of the image with no embedded metadata.

Args: path: Absolute path to the image file. output_path: Where to save. Defaults to _clean..

Rotate an image by a specified number of degrees.

Args: path: Absolute path to the image file. degrees: Rotation angle in degrees (counter-clockwise). expand: If True, expand the output to fit the full rotated image. output_path: Where to save. Defaults to _rotated..

Flip (mirror) an image horizontally or vertically.

Args: path: Absolute path to the image file. direction: 'horizontal' or 'vertical'. output_path: Where to save. Defaults to _flipped..

Apply a filter to an image.

Available filters: blur, sharpen, smooth, detail, contour, edge_enhance, emboss, grayscale.

Args: path: Absolute path to the image file. filter_name: Name of the filter to apply. output_path: Where to save. Defaults to _..

Get detailed information about a video file.

Returns duration, resolution, codec, bitrate, fps, and audio info. Requires ffprobe (part of ffmpeg) to be installed.

Args: path: Absolute path to the video file.

Extract frames from a video at regular intervals.

Args: path: Absolute path to the video file. interval_seconds: Time between extracted frames (default 1 second). max_frames: Maximum number of frames to extract (default 10). output_dir: Directory to save frames. Defaults to a 'frames' subdir next to the video. format: Image format for frames ('png' or 'jpg'). Default 'png'.

Convert a video to a different format or resolution.

Supported output formats: mp4, webm, mov, avi, gif, mkv.

Args: path: Absolute path to the video file. format: Target format (e.g. 'mp4', 'webm', 'gif'). output_path: Where to save. Defaults to .<new_ext>. resolution: Optional target resolution (e.g. '1280x720', '1920x1080'). crf: Constant Rate Factor for quality (0-51, lower = better). Default 23.