Ultimate Gemini MCP server

Ultimate Gemini MCP

MCP server for Google's Gemini 3.1 Flash Image — fast image generation with advanced reasoning, 512px–4K resolution, up to 14 reference images, Google Search grounding, and automatic thinking mode.

Setup

Claude Desktop

Add to your mcp config (mcp.json / .claude.json):

{
  "mcpServers": {
    "ultimate-gemini": {
      "command": "uvx",
      "args": ["ultimate-gemini-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "your-api-key-here"
      }
    }
  }
}

All generated images include invisible SynthID watermarks for authenticity and provenance tracking.

Features

Gemini 3.1 Flash Image

• High-Resolution Output: 512px, 1K, 2K, and 4K resolution
• Advanced Text Rendering: Legible, stylized text in infographics, menus, diagrams, and logos
• Up to 14 Reference Images: Up to 10 objects + 4 characters for style/character consistency
• Google Search Grounding: Real-time data (weather, stocks, events, maps)
• Google Image Search: Visual context from web images — the model can FIND real images of anything
• Thinking Mode: Configurable reasoning - "minimal" (fast) or "high" (best quality)
• Transparent Backgrounds: Flip one flag → ready-to-use transparent PNG/WebP cut-outs with a real alpha channel, recovered by a two-pass difference matte (generate on white → edit to black → solve for alpha). True soft edges/glow/glass, no color halo. Pillow only — no extra dependencies. Costs a second model call (~2x).
• Dedicated App-Icon / Logo Tool: generateappicon forces a square, transparent, 1024px PNG every time — no way to get a non-square or opaque-background icon

This model is different. Unlike traditional image generators that rely solely on training data, Gemini 3.1 Flash has live access to Google Search and Image Search. It can find actual references for products, people, events, or anything that exists online. "Way of Wade 12" → generates the REAL shoe. "Tony Hawk" → finds real photos. Don't over-prompt — let the model cook.

Server Features

• Batch Processing: Generate multiple images in parallel (up to 8 concurrent)
• 26 Expert Prompt Templates: MCP slash commands for photography, cinematics, storyboards, and more
• Flexible Aspect Ratios: 14 options — 1:1, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9
• Configurable via Environment Variables: Output directory, default size, timeouts, and more

Showcase

Photorealistic Capabilities

Jensen Huang — GPU Surfing

Elon Musk — Mars Chess Match

Jensen Huang — GPU Kitchen

Elon Musk — Cybertruck Symphony

Jensen Huang — Underwater Data Center

Elon Musk — SpaceX Skateboarding

Google Search Grounding

Shortened. The full README is on GitHub.