Why an MCP server for this
E-commerce and marketing
Resize and compress a folder of product photos to platform specs and add a brand watermark in one batch, without uploading them.
Web performance
Convert assets to WebP and tune quality to hit size budgets across an entire image directory.
Privacy and compliance
Strip EXIF GPS, device and timestamp metadata before sharing or archiving client and personal photos.
AI agents and automation
Give Claude Desktop or Cursor a local image tool for repeatable resize/convert pipelines with no third-party service.
What it does
- image_resize — batch resize by long edge (shrink-only), explicit width/height or percentage; accepts a single file or a whole folder.
- image_convert — convert between jpg, png, webp, bmp and tiff.
- image_compress — quality-based compression from 1 to 100, clamped to a safe range.
- image_watermark — semi-transparent corner text watermark with configurable size ratio and opacity.
- image_strip — rewrite images to remove EXIF metadata (camera, GPS, timestamp) for privacy.
- Built on Pillow, runs fully offline with no API key; image_selftest verifies all five operations end to end.
Install and connect
Published to the official MCP Registry as io.github.diyaluo/image-toolkit-mcp and as an OCI image on GHCR. Run locally over stdio:
pip install -e .
image_toolkit_mcpClient configuration (Claude Desktop / Cursor / any MCP client):
{
"mcpServers": {
"image-toolkit": {
"command": "image_toolkit_mcp",
"env": {}
}
}
}Frequently asked questions
What does this MCP server do?
It exposes batch image processing as MCP tools, so an MCP-compatible agent can resize, convert, compress, watermark and strip EXIF from a single image or an entire local folder.
Are my images uploaded anywhere?
No. The server runs locally on Pillow and communicates over stdio. Images never leave the machine, which makes it suitable for confidential client and personal photos.
Which image formats are supported?
Conversion and processing cover JPG/JPEG, PNG, WebP, BMP and TIFF, with sensible handling of RGBA and palette-mode images when saving to JPEG.
What does EXIF stripping remove?
image_strip rewrites each image without its EXIF block, removing camera model, GPS location and capture timestamp so shared files do not leak metadata.
Which MCP clients are supported?
Any Model Context Protocol client over stdio, including Claude Desktop and Cursor. It is published to the official MCP Registry as io.github.diyaluo/image-toolkit-mcp and on GHCR.