WebPerfect MCP Server

An intelligent MCP server with a fully automated batch pipeline for web-ready images. Features include noise reduction, auto levels/curves, JPEG artifact removal, 4K resizing, smart sharpening with shadow/highlight enhancement, and advanced WebP conversion. Optimized compression delivers smaller files without sacrificing quality.

Features

Advanced Image Processing Pipeline

Strong noise reduction using median filtering
Intelligent auto levels and curves based on image entropy
Advanced texture enhancement with modulation and sharpening
Smart resolution optimization (up to 4K)
Optimized WebP conversion

Tools

`process_images`

Process and optimize a batch of images with advanced enhancements.

{
  inputDir: string;      // Directory containing input images
  outputDir: string;     // Directory for optimized output
}

Resources

Resource Templates

logs/{date}: Access processing logs by date (YYYY-MM-DD)
{ "date": "2024-01-20", "entries": [{ "timestamp": "2024-01-20T10:00:00Z", "imagesProcessed": 15, "totalInputSize": "5.2MB", "totalOutputSize": "1.1MB", "compressionRatio": "78.8%", "averageProcessingTime": "1.2s" }] }
stats/monthly/{month}: Monthly statistics (YYYY-MM)
{ "month": "2024-01", "totalImagesProcessed": 450, "averageCompressionRatio": "82%", "popularFormats": { "input": ["JPEG", "PNG"], "output": ["WebP"] }, "totalStorageSaved": "150MB" }

Static Resources

stats/summary: Overall processing statistics
{ "totalImagesProcessed": 5280, "averageCompressionRatio": "81%", "totalStorageSaved": "1.8GB", "popularEnhancements": [ "noise_reduction", "auto_levels_curves", "texture_enhancement" ], "performanceMetrics": { "averageProcessingTime": "1.5s", "peakThroughput": "45 images/minute" } }
config/optimization-presets: Available optimization presets
{ "presets": { "web_standard": { "maxWidth": 1920, "format": "webp", "quality": 85, "enhancements": ["noise_reduction", "auto_levels_curves"] }, "web_high_quality": { "maxWidth": 3840, "format": "webp", "quality": 90, "enhancements": [ "noise_reduction", "auto_levels_curves", "texture_enhancement" ] }, "thumbnail": { "maxWidth": 400, "format": "webp", "quality": 80, "enhancements": ["noise_reduction"] } } }

Installation

Clone the repository:

git clone https://github.com/splendasucks/webperfect-mcp-server.git
cd webperfect-mcp-server

Install dependencies:

npm install

Build the server:

npm run build

Usage with Claude

Add the server to your Claude MCP settings (typically in claude_desktop_config.json):

{
  "mcpServers": {
    "webperfect": {
      "command": "node",
      "args": ["/path/to/webperfect-mcp-server/build/index.js"],
      "env": {}
    }
  }
}

Restart Claude to load the MCP server.
The server will be available through Claude's MCP tools and resources:

// Process a batch of images
<use_mcp_tool>
<server_name>webperfect</server_name>
<tool_name>process_images</tool_name>
<arguments>
{
  "inputDir": "/path/to/input",
  "outputDir": "/path/to/output"
}
</arguments>
</use_mcp_tool>

// Access processing statistics
<access_mcp_resource>
<server_name>webperfect</server_name>
<uri>stats/summary</uri>
</access_mcp_resource>

Requirements

Node.js >= 16
Sharp image processing library
Model Context Protocol SDK

License

MIT

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

process_images

Related MCP Servers

MCP NPX Fetch
tokenizin-agency
A
security
A
license
A
quality
A powerful MCP server for fetching and transforming web content into various formats (HTML, JSON, Markdown, Plain Text) with ease.
Last updated -
4
146
12
TypeScript
MIT License
MCP Read Images
catalystneuro
-
security
A
license
-
quality
An MCP server for analyzing images using OpenRouter vision models, offering capabilities like automatic image resizing, model configuration, and handling custom queries about images.
Last updated -
5
JavaScript
MIT License
Comfy MCP Server
lalanikarim
-
security
A
license
-
quality
The Comfy MCP Server uses the FastMCP framework to generate images from prompts by interacting with a remote Comfy server, allowing automated image creation based on workflow configurations.
Last updated -
7
Python
MIT License
Stability AI MCP Server
tadasant
A
security
A
license
A
quality
An MCP Server that integrates with Stability AI's API to provide high-quality image generation, editing, and manipulation capabilities including background removal, outpainting, search-and-replace, and upscaling.
Last updated -
13
35
55
TypeScript
MIT License

View all related MCP servers

WebPerfect MCP Server