MCP Image Compression
High-performance MCP server for compressing JPEG, PNG, WebP and AVIF images offline.
Add to your client
Copy the config for your MCP client and paste it into its config file.
npx -y @inhiblab-core/mcp-image-compressionPaste into ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"mcp-image-compression": {
"command": "npx",
"args": [
"-y",
"@inhiblab-core/mcp-image-compression"
],
"env": {
"IMAGE_COMPRESSION_DOWNLOAD_DIR": "<YOUR_DIR>"
}
}
}
}Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf
Before you start
- Node.js with npx (to run the published @inhiblab-core/mcp-image-compression package)
- An MCP-compatible client such as Claude Desktop, Cursor, or Windsurf
- A writable local directory set via the IMAGE_COMPRESSION_DOWNLOAD_DIR environment variable
- Optionally Docker, if building/running the server from the provided Dockerfile
About MCP Image Compression
mcp-image-compression is a high-performance image compression microservice built on the MCP architecture. It focuses on providing fast and high-quality image compression to help developers optimize image resources for websites and applications. It supports JPEG, PNG, WebP, and AVIF formats, runs fully offline, automatically selects optimal compression parameters based on image content, processes multiple images in parallel, and allows customizable compression quality to balance file size against visual quality. The single image_compression tool accepts image URLs plus a quality and format, and returns the URLs of the compressed images written to a configurable download directory.
Tools & capabilities (1)
image_compressionCompress one or more images. Inputs: urls (URLs of images to compress), quality (int, compression quality 0-100), and format (output format, e.g. "jpeg", "png", "webp", "avif"). Returns the URLs of the compressed images.
What this server can do
MCP Image Compression provides tools for these capabilities — tap one to see every MCP server that does the same:
When to use it
- Compressing website and app image assets to reduce file size and improve page load speed
- Batch-converting and compressing multiple images in parallel to a target format such as WebP or AVIF
- Optimizing images offline without sending them to an external service
- Tuning the quality/size trade-off for images via a customizable quality parameter
Security notes
No API key or authentication is required; the server runs locally over stdio and processes images offline. Set the IMAGE_COMPRESSION_DOWNLOAD_DIR environment variable to a directory where the server is allowed to write the compressed output files.
MCP Image Compression FAQ
Which image formats are supported?
The server supports JPEG, PNG, WebP, and AVIF for both input and output via the format parameter.
Does it require an internet connection or API key?
No. It works fully offline and requires no API key or authentication; compression runs locally.
Where are the compressed images saved?
Compressed files are written to the directory you set via the IMAGE_COMPRESSION_DOWNLOAD_DIR environment variable, and the tool returns the URLs of the compressed images.
Can I compress multiple images at once?
Yes. The image_compression tool accepts multiple URLs and the server supports parallel batch compression for improved efficiency.
Alternatives to MCP Image Compression
Compare all alternatives →
Control Blender from Claude and other LLMs for prompt-assisted 3D modeling, scene creation, and asset generation.
Popular community server that feeds Figma layout data to coding agents via a Figma API token.
Generate beautiful, modern UI components from natural-language descriptions inside your IDE.
Compare MCP Image Compression with: