# InhiblabCore/mcp-image-compression [Health: Active]

**Category:** 🎥 Multimedia Process  
**Repository:** https://github.com/InhiblabCore/mcp-image-compression  
**GitHub Stars:** 34  
**npm Downloads (last month):** 45  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/inhiblabcore-mcp-image-compression

## Description
MCP server for local compression of various image formats.

## Tools
Capabilities this server exposes over MCP:

- **urls**
- **quality**
- **format**

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "mcp-image-compression": {
    "command": "npx",
    "args": ["-y","@inhiblab-core/mcp-image-compression"],
    "env": {
      "IMAGE_COMPRESSION_DOWNLOAD_DIR": ""
    }
  }
}
```

**Requires environment variables:** `IMAGE_COMPRESSION_DOWNLOAD_DIR` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What InhiblabCore/mcp-image-compression does

InhiblabCore/mcp-image-compression is an MCP server for compressing image resources locally. It targets common web and application formats: JPEG, PNG, WebP, and AVIF. The service is intended for workflows where reducing file size, controlling visual quality, or converting an image to another supported format is part of an agent-driven process.

The server exposes one MCP operation, `image_compression`. Its inputs are `urls`, `quality`, and `format`. `urls` identifies the images to process, `quality` sets the compression level from 0 to 100, and `format` selects an output such as `jpeg`, `png`, `webp`, or `avif`. The result is a URL for the compressed image or images.

This places the project in the 🎥 Multimedia Process category. It is a fit for asset preparation, image optimization, and format conversion tasks handled through an MCP-compatible client.

## How it works

An MCP client invokes `image_compression` with the image URL or URLs and the requested settings. The service performs compression locally and returns references to the resulting files.

Multiple images can be processed in parallel according to the project documentation. That makes the server suitable for batches of assets rather than only one-off conversions. The documented workflow does not require an internet connection for the compression service, although the tool input is expressed as image URLs.

## Setup and configuration

The documented setup uses NPX. Add a server entry that runs `npx -y @inhiblab-core/mcp-image-compression` to an MCP client configuration. The example also sets `IMAGE_COMPRESSION_DOWNLOAD_DIR` to the directory used for downloaded or generated image files; replace the placeholder with a path available to the local process.

A Docker image can be built with `docker build -t mcp-image-compression .`. The project is licensed under MIT.

## Tools and capabilities

The InhiblabCore/mcp-image-compression MCP server provides:

- `image_compression` for compressing images identified by URL.
- Quality control through an integer value from 0 to 100.
- Output conversion to JPEG, PNG, WebP, or AVIF.
- Local, offline-oriented processing.
- Parallel handling of multiple images, as described by the project.
- Returned URLs for the compressed results.

The server does not document separate MCP tools for inspecting metadata, comparing file sizes, or editing image dimensions.

## Limitations and notes

The InhiblabCore/mcp-image-compression MCP server documents URL-based inputs and compressed-image URLs as outputs, so callers should account for how their client and local environment resolve and store those files. Quality values and format names should therefore follow the documented ranges and examples.

The README calls the protocol “Modal Context Protocol” in one place, but the project is presented as an MCP server and configured using standard MCP server settings. No client-specific configuration is provided.

_Full upstream README: https://allmcps.com/mcp/inhiblabcore-mcp-image-compression/readme_