Mcp Image Optimizer

What is Mcp Image Optimizer?

Mcp Image Optimizer is an MCP server that lets AI assistants like Claude, OpenAI Codex, and Cursor resize, convert, and transform images. It is built for developers and content creators who want to process images programmatically through natural language commands.

How to use Mcp Image Optimizer?

Install via npx -y mcp-image-optimizer or globally with npm install -g mcp-image-optimizer. Add the server to your MCP client’s configuration (e.g., Claude Desktop, VS Code, Cursor) using the command npx with args ["mcp-image-optimizer"]. Then ask your AI assistant any of the supported image operations using file paths or URLs.

Key features of Mcp Image Optimizer?

• Resize, convert, and transform images in multiple formats
• Batch process multiple images at once
• Intelligent cropping and auto-crop to remove borders
• Generate low-quality image placeholders for lazy loading
• Add image or text watermarks with positioning options
• Generate all favicon sizes and formats for web apps

Use cases of Mcp Image Optimizer?

• Optimize a single image to a specific width and quality for web use
• Batch convert a folder of images to WebP or AVIF
• Create a 200x200 thumbnail with smart crop for a product catalog
• Add a copyright text watermark diagonally across documents
• Generate a full favicon set (16x16 to 512x512) plus PWA icons from a logo

FAQ from Mcp Image Optimizer

What are the system requirements?

Node.js 22+ is required. The server is compatible with any MCP client that supports npx or globally installed Node packages.

Can I use URLs instead of local file paths?

Yes, URLs like https://example.com/image.jpg are supported, as well as absolute paths and home directory paths. Relative paths require setting a cwd in the client config.

What image formats are supported for output?

JPEG, PNG, WebP, AVIF, and TIFF are supported as output formats. The server can read the same formats plus others via input.

How do I troubleshoot “command not found” errors?

Ensure Node.js is installed (node --version). If using npx, try the global install method (npm install -g mcp-image-optimizer) and restart your MCP client after updating the config with the global command.

What tools does the server provide?

Eight tools: optimize_image, batch_optimize, get_image_info, auto_crop, smart_crop, create_placeholder, add_watermark, and generate_favicon. Each has configurable parameters like width, height, quality, format, and fit mode.