PluginBench
MCP Server

io.github.shinpr/mcp-image MCP Server

io.github.shinpr/mcp-image

RepositoryRegistry

What is the io.github.shinpr/mcp-image MCP server?

AI image generation and editing with prompt optimization and quality presets

How to install io.github.shinpr/mcp-image

Copy-paste configuration for popular MCP clients.

transport: stdio
Config generated by PluginBench — verify against the source before use.
Environment / auth
  • IMAGE_PROVIDER

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

  • GEMINI_API_KEY
    secret

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

  • OPENAI_API_KEY
    secret

    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
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "mcp-image": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-image"
      ],
      "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>"
      }
    }
  }
}
Cursor
~/.cursor/mcp.json
{
  "mcpServers": {
    "mcp-image": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-image"
      ],
      "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>"
      }
    }
  }
}
Windsurf
~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "mcp-image": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-image"
      ],
      "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>"
      }
    }
  }
}
VS Code
.vscode/mcp.json
{
  "servers": {
    "mcp-image": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-image"
      ],
      "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>"
      }
    }
  }
}
Claude Code
claude mcp add mcp-image --env IMAGE_PROVIDER=<YOUR_IMAGE_PROVIDER> --env GEMINI_API_KEY=<YOUR_GEMINI_API_KEY> --env OPENAI_API_KEY=<YOUR_OPENAI_API_KEY> --env IMAGE_OUTPUT_DIR=<YOUR_IMAGE_OUTPUT_DIR> --env IMAGE_QUALITY=<YOUR_IMAGE_QUALITY> --env SKIP_PROMPT_ENHANCEMENT=<YOUR_SKIP_PROMPT_ENHANCEMENT> -- npx -y mcp-image

Related MCP servers

io.github.shinpr/mcp-local-rag

Easy-to-setup local RAG server with minimal configuration

View repository →

io.github.shinpr/sub-agents-mcp

MCP server for delegating tasks to specialized AI assistants in Cursor, Claude, and Gemini

View repository →