Gemini Image MCP Server

An MCP (Model Context Protocol) server that provides AI image generation tools using Google's Gemini models. Supports single and batch image generation, multiple reference images, WebP conversion, and direct WordPress upload.

• Two quality tiers -- Pro (Gemini 3 Pro Image Preview, up to 4K) and Fast (Gemini 2.5 Flash Image, 1K max)
• Reference images -- up to 14 reference images per generation (Pro mode)
• Batch generation -- queue multiple images, review, then generate in one run
• WebP conversion -- convert PNG/JPG to WebP for web optimization
• WordPress upload -- upload WebP images directly to WordPress media library
• Configurable -- all paths, limits, and delays via config.json

git clone https://github.com/YOUR_USERNAME/gemini-image-mcp.git
cd gemini-image-mcp

# Create config from example
cp config.json.example config.json
cp .env.example .env

Edit .env:

GEMINI_API_KEY=your-gemini-api-key-here

Update paths in config.json to match your system. The images_dir path supports ~ expansion.

pip install requests

WebP conversion also requires uv and Pillow (handled automatically by uv).

{
  "mcpServers": {
    "gemini-custom": {
      "command": "python3",
      "args": ["/path/to/gemini-image-mcp/src/gemini_image_server.py"],
      "env": {
        "GEMINI_API_KEY": "your-key-here"
      }
    }
  }
}

See docs/systemd-service.example for a template.

gemini-image-mcp/
├── src/
│   ├── gemini_image_server.py   # Main MCP server
│   ├── batch_manager.py         # Batch queue management
│   └── batch_generate.py        # Batch image generation
├── scripts/
│   └── webp-convert.py          # PNG/JPG to WebP converter
├── skills/
│   ├── gemini-image-generation-SKILL.md        # Claude skill file
│   └── example-brand-image-guidelines-SKILL.md # Brand template skill
├── docs/
│   └── systemd-service.example  # Systemd service template
├── config.json.example          # Configuration template
├── .env.example                 # Environment variable template
├── .gitignore
├── LICENSE
└── README.md

config.json fields:

The skills/ directory contains Claude Code skill files:

• gemini-image-generation-SKILL.md -- comprehensive guide for using the image generation tools, prompt engineering, workflows, and troubleshooting
• example-brand-image-guidelines-SKILL.md -- template for creating brand-specific image generation guidelines

Copy these to your Claude Code skills directory to give Claude detailed knowledge of how to use this server.

MIT