Which integrations are available for this server?

Generates and transforms images using Google's Gemini AI models, supporting text-to-image generation and image editing with natural language prompts.

How do I use Gemini Image Generator MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Gemini Image Generator MCP Server generate a photorealistic cat on a windowsill" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Gemini Image Generator MCP Server

by jonchun

Overview Schema Source Related Servers Discussions Admin

Python

Remote

Cover

Gemini Image Generator MCP Server

Generate and transform images using Google's Gemini AI through the Model Context Protocol (MCP).

Features

Text-to-Image Generation - Create images from natural language prompts
Image Transformation - Modify existing images with text descriptions
Automatic Filename Generation - Smart naming based on prompts
Multi-Language Support - Automatic prompt translation to English

Related MCP server: Gemini Image MCP

Installation

Get a free API key from Google AI Studio.

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

# Using uv (recommended)
uv venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
uv pip install -e .

Configuration

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "gemini-image-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/gemini-image-mcp",
        "run",
        "gemini-image-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "your-api-key-here",
        "DEFAULT_OUTPUT_IMAGE_PATH": "/path/to/images"
      }
    }
  }
}

{
  "gemini-image-mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "/ABSOLUTE/PATH/TO/gemini-image-mcp",
      "run",
      "gemini-image-mcp"
    ],
    "env": {
      "GEMINI_API_KEY": "your-api-key-here",
      "DEFAULT_OUTPUT_IMAGE_PATH": "/path/to/images"
    }
  }
}

Install from smithery.ai - search for "gemini-image-mcp".

Usage

Generate Images

Generate a photorealistic sunset over mountains with purple sky

Sunset example

Create a British Shorthair silver tabby kitten playing with a ball of yarn

Kitten example

Transform Images

Prompt: Add beautiful vibrant aurora borealis (northern lights) dancing across the sky with green, purple, and blue colors

Sunset with aurora

Prompt: Add soft natural sunlight streaming through a window, creating beautiful warm light rays and gentle shadows

Kitten with sunbeams

Available Tools

`generate_image_from_text`

Creates an image from a text description.

Parameters:

prompt (required): Text description of the image
output_dir (optional): Directory to save the image
model (optional): Gemini model to use (defaults to GEMINI_MODEL environment variable)

Returns: Path to the saved image file

`transform_image_from_file`

Transforms an existing image based on a text prompt.

Parameters:

image_file_path (required): Path to the source image
prompt (required): Description of the transformation
output_dir (optional): Directory to save the image
model (optional): Gemini model to use (defaults to GEMINI_MODEL environment variable)

Returns: Path to the transformed image file

`transform_image_from_encoded`

Transforms a base64-encoded image.

Parameters:

encoded_image (required): Base64 data URL (data:image/[format];base64,[data])
prompt (required): Description of the transformation
output_dir (optional): Directory to save the image
model (optional): Gemini model to use (defaults to GEMINI_MODEL environment variable)

Returns: Path to the transformed image file

Configuration

Variable	Required	Default	Description
`GEMINI_API_KEY`	Yes	-	Your Gemini API key
`DEFAULT_OUTPUT_IMAGE_PATH`	No	Current directory	Default save location
`GEMINI_MODEL`	No	`gemini-2.5-flash-image`	Model to use
`GEMINI_BASE_URL`	No	`https://generativelanguage.googleapis.com`	API base URL

Development

Test the server locally:

fastmcp dev src/gemini_image_mcp/server.py

Opens MCP Inspector at http://localhost:5173/

License

MIT

Available Tools

3 tools

generate_image_from_textA

Generate an image from a text prompt using Gemini.

Args: prompt: Text description of the desired image. output_dir: Optional directory to save the generated image. If not provided, the image is only returned in the response (not saved to disk). model: Optional Gemini model name. If not provided, uses GEMINI_MODEL environment variable. ctx: Optional context for progress reporting.

Returns: List containing ImageContent with the generated image, and optionally TextContent with file path if saved.

Inputs: prompt (required), model, output_dir. Returns: result

transform_image_from_encodedA

Transform a base64-encoded image using Gemini.

Args: encoded_image: Base64 data URL (data:image/[format];base64,[data]). prompt: Text description of desired transformation. output_dir: Optional directory to save the generated image. If not provided, the image is only returned in the response (not saved to disk). model: Optional Gemini model name. If not provided, uses GEMINI_MODEL environment variable. ctx: Optional context for progress reporting.

Returns: List containing ImageContent with the transformed image, and optionally TextContent with file path if saved.

Inputs: prompt (required), encoded_image (required), model, output_dir. Returns: result

transform_image_from_fileA

Transform an image file using Gemini.

Args: image_file_path: Path to the source image file. prompt: Text description of desired transformation. output_dir: Optional directory to save the generated image. If not provided, the image is only returned in the response (not saved to disk). model: Optional Gemini model name. If not provided, uses GEMINI_MODEL environment variable. ctx: Optional context for progress reporting.

Returns: List containing ImageContent with the transformed image, and optionally TextContent with file path if saved.

Inputs: prompt (required), image_file_path (required), model, output_dir. Returns: result

Tool Schema Changelog

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

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4/5.0

Scored 2026-09-13 13:20 across 3 tools

Disambiguation5/5

Each tool has a clearly distinct purpose: text-to-image generation versus image transformation from two different input sources (encoded data or file path). The input types prevent confusion, and descriptions explicitly state the expected arguments.

Naming Consistency5/5

All tool names follow the same snake_case verb_noun_preposition pattern (generate_image_from_text, transform_image_from_encoded, transform_image_from_file). The convention is consistent and predictable.

Tool Count5/5

Three tools are well-scoped for an image generation and transformation server; each tool covers a distinct input method without redundancy. No tool feels superfluous or missing from a minimal set.

Completeness4/5

The server covers the core lifecycle: generating an image from text and transforming existing images from both encoded data and file paths. Minor gaps exist (e.g., no batch generation or targeted editing), but the primary workflows are supported.

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Claude ImagineA
com.claudeimagine
Generate AI images and videos from any compatible MCP client.
AI & Machine Learning Image & Video Processing
112
https://claudeimagine.com/api/mcp
Writingmate MCP
ai.writingmate
Use AI models for chat, image, and video generation from Claude Code and other MCP hosts.
AI & Machine Learning Image & Video Processing
1
https://writingmate.ai/api/mcp
ShadowTeck
com.shadowteck
Generate AI video, images and audio, and browse your history, from any MCP client.
AI & Machine Learning Image & Video Processing Audio Processing
1
https://shadowteck.com/api/mcp
mcpA
com.pixfaro
Generate images with any major model — one API key, one prepaid balance, one MCP.
AI & Machine Learning Image & Video Processing
81
https://mcp.pixfaro.com/mcp

Related MCP Servers

Gemini Image Generator MCP
Image & Video Processing Autonomous Agents
qhdrl12
A
license
A
quality
D
maintenance
Allows AI assistants to generate and transform high-quality images from text prompts using Google's Gemini model via the MCP protocol.
Updated 8 months ago (2026-03-15 15:36 UTC)
3
34
MIT
Gemini Image MCP
Image & Video Processing Multimedia Processing Autonomous Agents
jk7g14
A
license
B
quality
D
maintenance
Enables image generation and multi-turn editing sessions using the Gemini API within MCP-compatible environments. Users can create, modify, and configure images through natural language commands, supporting features like aspect ratio adjustments and session-based image transformations.
Updated 9 months ago (2026-02-09 01:53 UTC)
5
ISC
Nano Banana MCP
Image & Video Processing AI & Machine Learning
charlesdove977
A
license
A
quality
C
maintenance
MCP server for Google Gemini image generation with configurable model support, enabling text-to-image generation, image editing, and iterative refinement.
Updated 19 days ago (2026-10-23 16:44 UTC)
6
40
MIT
Gemini Image Generation MCP
Image & Video Processing AI & Machine Learning
AffanShaikhsurab
F
license
Not graded
quality
D
maintenance
Provides image generation capabilities using Google's Gemini 2.0 Flash Preview model through the MCP protocol, enabling AI assistants to generate high-quality images from text prompts.
Updated a year ago (2025-07-31 19:02 UTC)
-

Gemini Image Generator MCP Server

Features

Installation

Configuration

Usage

Generate Images

Transform Images

Available Tools

generate_image_from_text

transform_image_from_file

transform_image_from_encoded

Configuration

Development

License

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers