Ultimate Gemini MCP

stdio

Image generation with Google Gemini 3.1 Flash: 512px-4K, reference images, search grounding

Getting Started

npx @getmcp/cli add io.github.nikships/ultimate-image-gen-mcp

Requires Python 3.10+. Community-contributed server. Review source before installing.

Claude Desktopguide →Vscodeguide →Cursorguide →Windsurfguide →

Required Environment Variables

GEMINI_API_KEY
Google Gemini API key (free tier at https://aistudio.google.com/apikey). Also accepts GOOGLE_API_KEY.

Configuration

Config file: ~/Library/Application Support/Claude/claude_desktop_config.json

JSON

{
  "mcpServers": {
    "io.github.nikships/ultimate-image-gen-mcp": {
      "command": "uvx",
      "args": [
        "ultimate-gemini-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "",
        "OUTPUT_DIR": "~/gemini_images",
        "DEFAULT_IMAGE_SIZE": "2K",
        "DEFAULT_MODEL": "gemini-3.1-flash-image-preview",
        "ENABLE_PROMPT_ENHANCEMENT": "false",
        "ENABLE_GOOGLE_SEARCH": "false",
        "REQUEST_TIMEOUT": "60",
        "MAX_BATCH_SIZE": "8",
        "LOG_LEVEL": "INFO"
      }
    }
  }
}

Claude Desktop MCP documentation