io.github.shinpr/mcp-image

Official

by shinpr · TypeScript

AI image generation and editing with prompt optimization and quality presets

Generate and edit images with AI using optimized prompts and quality presets.

Topics

cursorgeminiimage-generationmcp-servercodexclaude-codegenerative-aimcpskillsagent-skillsai-toolsimage-editingmodel-context-protocolprompt-optimizationgpt-image-2

Install

Configuration

Environment variables

IMAGE_PROVIDER

Image provider to use: 'gemini' (default) or 'openai'

GEMINI_API_KEYsecret

Google Gemini API key for image generation when IMAGE_PROVIDER=gemini (get from https://aistudio.google.com/apikey)

OPENAI_API_KEYsecret

OpenAI API key for image generation when IMAGE_PROVIDER=openai. Requires OpenAI organization verification to access gpt-image-2 (https://platform.openai.com/settings/organization/general)

IMAGE_OUTPUT_DIR

Absolute path to directory where generated images will be saved (defaults to ./output)

IMAGE_QUALITY

Default quality preset: 'fast' (Nano Banana 2, default), 'balanced' (Nano Banana 2 + thinking), 'quality' (Nano Banana Pro)

SKIP_PROMPT_ENHANCEMENT

Set to 'true' to disable automatic prompt optimization and use direct prompts

claude_desktop_config.json

{
  "mcpServers": {
    "mcp-image": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-image@0.11.2"
      ],
      "env": {
        "IMAGE_PROVIDER": "<YOUR_IMAGE_PROVIDER>",
        "GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>",
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "IMAGE_OUTPUT_DIR": "<YOUR_IMAGE_OUTPUT_DIR>",
        "IMAGE_QUALITY": "<YOUR_IMAGE_QUALITY>",
        "SKIP_PROMPT_ENHANCEMENT": "<YOUR_SKIP_PROMPT_ENHANCEMENT>"
      }
    }
  }
}