Mcp Image Optimizer

Name: Mcp Image Optimizer
Author: piephai

@piephai

Mcp Image Optimizer について

A Model Context Protocol server for image optimization. Process images from URLs or local files with advanced transformations powered by Sharp.

#sharp #mcp #image #resize

基本情報

カテゴリ

メディアとデザイン

トランスポート

stdio

公開者

piephai

投稿者

Phai

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "image-optimizer": {
      "command": "npx",
      "args": [
        "mcp-image-optimizer"
      ]
    }
  }
}

ツール

Optimize an image from a file path or URL with various transformation options

Optimize multiple images at once

Get metadata and information about an image

Automatically crop image to remove borders, whitespace, or solid color backgrounds

Intelligently crop image to specified dimensions using entropy or attention detection

Generate a low-quality image placeholder (LQIP) for lazy loading

Add a watermark image or text to an image

Generate all favicon sizes and formats needed for modern web apps

概要

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.