@moeloubani/libvips-mcp-server

# 🎨 libvips MCP Server Enhanced Edition - Complete Capabilities ## Overview **30 Professional Image Processing Tools** powered by libvips, Sharp, and wasm-vips --- ## 📊 Basic Information & Analysis (3 tools) ### `image_info` Get comprehensive image metadata including dimensions, format, color space, channels, resolution, and file statistics. ### `image_histogram` Generate detailed histogram statistics for image analysis with configurable bin counts. ### `image_advanced_stats` Calculate comprehensive image statistics using wasm-vips including min/max, averages, histograms, field analysis, and enhanced metadata. --- ## 🔧 Basic Operations (5 tools) ### `image_resize` Resize images with various fit modes (cover, contain, fill, inside, outside) and advanced kernel options (nearest, linear, cubic, mitchell, lanczos). ### `image_convert` Convert between formats (JPEG, PNG, WebP, TIFF, AVIF, HEIF, GIF, BMP) with quality control and compression options. ### `image_crop` Extract rectangular regions from images with precise coordinate control. ### `image_rotate` Rotate images by any angle with configurable background colors. ### `image_flip` Flip images horizontally or vertically. --- ## 🎨 Image Enhancement (6 tools) ### `image_blur` Apply Gaussian blur with configurable sigma values for various blur intensities. ### `image_sharpen` Apply unsharp mask sharpening with configurable sigma, flat, and jagged parameters. ### `image_adjust_brightness` Adjust image brightness (-100 to +100 range). ### `image_adjust_contrast` Adjust image contrast (0.1 to 3.0 multiplier). ### `image_adjust_saturation` Adjust color saturation (0.0 to 2.0 multiplier). ### `image_grayscale` Convert images to grayscale. --- ## 🔬 Morphological Operations (1 tool) ### `image_morphology` Apply erosion, dilation, opening, and closing operations with custom kernel sizes and iteration counts. Powered by wasm-vips with Sharp fallbacks. --- ## ✏️ Drawing Operations (2 tools) ### `image_draw_line` Draw lines with custom colors, widths, and precise coordinate control. ### `image_draw_circle` Draw circles and filled circles with custom colors and radius control. --- ## 🔍 Edge Detection (1 tool) ### `image_edge_detection` Apply advanced edge detection algorithms: Sobel, Prewitt, Roberts, and Laplacian filters with threshold control. --- ## 🔬 Advanced Scientific Operations (8 tools) ### `image_fft` Apply Fast Fourier Transform for frequency domain analysis and filtering, with inverse FFT support. ### `image_custom_convolution` Apply custom convolution kernels for advanced filtering effects with scale and offset parameters. ### `image_colorspace_convert` Convert between color spaces: sRGB, LAB, HSV, CMYK, XYZ, scRGB, and LCH. ### `image_add_noise` Add various types of noise: Gaussian, uniform, or salt-and-pepper with configurable intensity. ### `image_texture_analysis` Analyze image texture using statistical measures and window-based analysis. ### `image_perspective_transform` Apply perspective transformations with custom corner point definitions. ### `image_flood_fill` Fill connected regions with specified colors and tolerance levels. ### `image_create_pyramid` Create image pyramids for multi-resolution processing and analysis with configurable levels and scale factors. --- ## 🎭 Composition & Effects (2 tools) ### `image_composite` Composite multiple images with various blend modes (over, multiply, screen, overlay, darken, lighten, etc.). ### `image_thumbnail` Create thumbnails with optional square cropping and size control. --- ## 🎨 Channel Operations (1 tool) ### `image_extract_channel` Extract individual color channels (Red, Green, Blue, Alpha) from images. --- ## 🎨 Creative Tools (1 tool) ### `create_solid_color` Generate solid color images of any size with hex color specification. --- ## 🚀 Technology Stack - **wasm-vips**: Access to full libvips API (300+ operations) - **Sharp**: High-performance image processing (built on libvips) - **Graceful Fallbacks**: Sharp approximations when wasm-vips unavailable - **TypeScript**: Full type safety and IntelliSense support - **MCP Protocol**: Compatible with all MCP clients --- ## 📈 Performance Characteristics - **Memory Efficient**: Processes images larger than RAM using streaming - **Thread Safe**: Automatic parallelization across CPU cores - **Streaming**: Demand-driven processing minimizes memory usage - **Caching**: Operation results cached for repeated operations - **Linear Scaling**: Performance scales with CPU cores (up to 32+ threads) --- ## 🎯 Use Cases ### Professional Photography - RAW processing, color correction, format conversion - Batch processing, watermarking, metadata extraction ### Scientific Imaging - Medical imaging analysis, microscopy processing - Frequency domain analysis, texture analysis ### Web Development - Thumbnail generation, format optimization - Responsive image creation, compression ### Computer Vision - Preprocessing for ML models, edge detection - Morphological operations, noise reduction ### Creative Arts - Digital art creation, effect application - Perspective correction, artistic filters --- ## 📊 Supported Formats ### Input Formats JPEG, PNG, TIFF, WebP, AVIF, HEIF, GIF, SVG, PDF, BMP, and many scientific formats ### Output Formats JPEG, PNG, WebP, TIFF, AVIF, HEIF, GIF, BMP with quality and compression control --- *Total: **30 Professional Tools** for comprehensive image processing*