v1.1.0 - Streaming, Caching & Optimization

🚀 New Features

⚡ Real-time Streaming Support

• Server-Sent Events (SSE) endpoint at /mcp/stream
• Live progress updates during image generation
• Partial image previews (1-3 configurable)
• Seamless error handling in stream

💾 Intelligent Caching System

• Two-tier caching (memory + disk)
• Content-based cache keys using SHA256
• Configurable TTL and size limits
• New tools: clear_cache and cache_stats
• Automatic cleanup when limits exceeded

🖼️ Image Optimization Engine

• Automatic compression with Sharp library
• Support for JPEG, PNG, and WebP formats
• Configurable quality/compression levels
• Typical size reductions of 30-80%
• Preserves transparency when needed

🔧 Enhanced Configuration

• New environment variables for cache control
• output_compression parameter for quality
• partialImages parameter for streaming
• format parameter for output format

📝 Documentation

• Comprehensive API documentation
• Environment configuration guide
• Updated examples with streaming demos
• Complete changelog

🐛 Bug Fixes

• Removed unsupported response_format parameter
• Improved error handling for API failures
• Better base64 encoding for large images
• Fixed package-lock.json sync issues

📦 Installation

npm install mcp-server-gpt-image@1.1.0

Or clone and build:

git clone https://github.com/pavelsukhachev/mcp-server-gpt-image.git
cd mcp-server-gpt-image
npm install
npm run build

🏃 Quick Start

Claude Desktop

Add to your Claude Desktop config:

{
  "mcpServers": {
    "gpt-image": {
      "command": "node",
      "args": ["/path/to/mcp-server-gpt-image/dist/index.js", "stdio"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key-here"
      }
    }
  }
}

HTTP Server

npm run start:http

See the README for full documentation.