Skip to main content
Glama

Gemini Image MCP

A Model Context Protocol (MCP) server for AI image generation using Google's Gemini 3.0 models (Nano Banana Pro).

Features

  • generate_image - Create images from text prompts with up to 4K resolution

  • edit_image - Modify existing images with instructions, style transfer, multi-image mixing

  • describe_image - Analyze and describe images

  • Reference Images - Support for up to 14 reference images for style/content guidance

Related MCP server: Nano Banana MCP Server

Installation

npm install
npm run build

Configuration

Claude Code CLI

claude mcp add gemini-image --env GEMINI_API_KEY=your_key -- node /path/to/dist/index.js

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "gemini-image": {
      "command": "node",
      "args": ["/path/to/dist/index.js"],
      "env": {
        "GEMINI_API_KEY": "your_api_key_here"
      }
    }
  }
}

Zed Editor

Copy and paste this prompt to your Zed AI assistant:

Install the gemini-image MCP server for me. Here's what you need to do:

1. Clone the repo and build it:
   git clone https://github.com/dfeirstein/gemini-image-mcp.git ~/.config/zed/mcp-servers/gemini-image-mcp
   cd ~/.config/zed/mcp-servers/gemini-image-mcp
   npm install
   npm run build

2. Add this to my Zed settings.json under "context_servers":
   {
     "context_servers": {
       "gemini-image": {
         "command": {
           "path": "node",
           "args": ["~/.config/zed/mcp-servers/gemini-image-mcp/dist/index.js"],
           "env": {
             "GEMINI_API_KEY": "YOUR_API_KEY_HERE"
           }
         }
       }
     }
   }

3. Remind me to replace YOUR_API_KEY_HERE with my actual Gemini API key from https://aistudio.google.com/apikey

The MCP provides three tools: generate_image, edit_image, and describe_image using Google's Gemini 3.0 (Nano Banana Pro) models.

Get API Key

Get a Gemini API key from Google AI Studio.

Note: Gemini 3 Pro Image (Nano Banana Pro) requires billing enabled - no free tier.

Usage Examples

Generate Image

Generate a cyberpunk cityscape at night with neon lights

With high resolution:

Generate a detailed landscape at 4K resolution

Edit Image

Add sunglasses to this photo
Remove the background
Apply a watercolor style

Describe Image

What objects are in this image?
Describe the mood and composition

Models

Model

ID

Description

Nano Banana Pro

gemini-3-pro-image-preview

Best quality, up to 4K resolution (default)

Flash

gemini-2.5-flash-preview-05-20

Faster, good for descriptions

Legacy

gemini-2.0-flash-exp

Fallback option

Parameters

Image Size (Nano Banana Pro)

  • 1K - Standard resolution (default)

  • 2K - High resolution

  • 4K - Ultra high resolution

Aspect Ratio

  • 1:1 - Square (default)

  • 3:4 - Portrait

  • 4:3 - Landscape

  • 9:16 - Tall portrait

  • 16:9 - Widescreen

License

MIT

Available Tools

3 tools
describe_imageB

Analyze and describe one or more images using Google Gemini. Returns text description only.

Inputs: images (required), prompt, model.

edit_imageC

Edit one or more images using Google Gemini 3.0 (Nano Banana Pro). Supports style transfer, object manipulation, and multi-image mixing.

Inputs: prompt (required), images (required), model, imageSize, +1 more.

generate_imageC

Generate an image using Google Gemini 3.0 (Nano Banana Pro). Supports up to 4K resolution and up to 14 reference images for style/content guidance.

Inputs: prompt (required), model, aspectRatio, imageSize, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: describe_image analyzes images, edit_image modifies existing images, and generate_image creates new images. There is no overlap in functionality, making it easy for an agent to select the correct tool.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern (describe_image, edit_image, generate_image) with the same noun and clear action verbs. The naming is predictable and readable throughout.

    Tool Count5/5

    With 3 tools, this server is well-scoped for image processing with Gemini. Each tool earns its place by covering a distinct aspect: analysis, editing, and generation, which is appropriate for the domain.

    Completeness5/5

    The tool set provides complete coverage for the image processing domain with Gemini: describe for analysis, edit for modification, and generate for creation. There are no obvious gaps, and agents can handle core workflows without dead ends.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers