iplanwebsites/image-mcp

Image MCP Server

An MCP (Model Context Protocol) server that provides AI image generation capabilities using the ai-image npm module, which wraps around OpenAI and Replicate image inference APIs.

Features

• generate_ai_image: Generate AI images with customizable prompts, sizes, models, and styles
• square_image: Generate square images (1024x1024) - shortcut command
• landscape_image: Generate landscape images (1536x1024) - shortcut command
• portrait_image: Generate portrait images (1024x1536) - shortcut command
• Built on the ai-image module for seamless integration with OpenAI and Replicate APIs
• Simple setup and configuration

Installation

npm install -g image-mcp

Setup

Claude Desktop Configuration

Add the following to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "image-mcp": {
      "command": "npx",
      "args": ["image-mcp@latest"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key",
        "REPLICATE_API_TOKEN": "your-replicate-api-token",
        "MCP_TIMEOUT": "1200000"
      },
      "resetTimeoutOnProgress": true
    }
  }
}

Environment Variables

The server requires API keys for the underlying image generation services:

• OPENAI_API_KEY: Your OpenAI API key for GPT-based models (we won't be supporting Dall-e models as they'll likely be dropped soon)
• REPLICATE_API_TOKEN: Your Replicate API token for other AI models

Usage

Once configured, you can use the image generation functions through Claude:

generate_ai_image

Generate AI images with various parameters:

• prompt (required): Text description of the image to generate
• size (optional): Image dimensions in WIDTHxHEIGHT format (default: "1024x1024")
• model (optional): Specific AI model to use
• output (optional): Custom output file path

Shortcut Commands

For convenience, use these preset size commands:

• square_image: Generate 1024x1024 square images
• landscape_image: Generate 1536x1024 landscape images
• portrait_image: Generate 1024x1536 portrait images

All shortcut commands accept the same parameters as generate_ai_image except size (which is preset).

Example prompts:

• "A red cat in Picasso style"
• "A sunset over mountains, photorealistic"
• "Abstract geometric patterns in blue and gold"

Development

# Clone the repository
git clone https://github.com/iplanwebsites/image-mcp.git
cd image-mcp

# Install dependencies
npm install

# Run in development mode
npm run dev

# Start the server
npm start

Requirements

• Node.js >= 18.0.0
• Valid API keys for OpenAI and/or Replicate

TODOs

Urgent

• Fix npm module issue: It only works locally...

Improvements

• Better guides: Add more detailed setup guides with troubleshooting steps, an Add to cursor button, etc

• Use ai-image library directly: Replace subprocess CLI calls with direct library imports

• Return file paths: Return created image file paths in response

• Local inference support: Add support for local models like Flux

• Image optimization: Add lightweight image resizing and optimization options

• Image captioning tool: Add captioning model for basic use cases (useful for models without vision)

License

MIT