Gemini Image MCP Server

An MCP server for image generation using the Gemini API.

Local serverstdio

What is the Gemini Image MCP Server?

Gemini image mcp server connects Gemini Image to AI assistants that speak the Model Context Protocol. An MCP server for image generation using the Gemini API.

What Gemini Image does

This is an MCP (Model Context Protocol) server that uses Google's Gemini API to generate images and save them to a specified directory. In addition to text prompts, you can optionally provide input images to guide the image generation process. Generated images are automatically compressed to reduce file size.

Key capabilities

  • Image generation from text prompts
  • (Optional) Image generation using input reference images
  • Automatic compression of generated images (JPEG, PNG)
  • Unique file name assignment to prevent file name conflicts
  • Operates as an MCP server, accepting tool calls via standard input/output

Requirements

  • Node.js (v18 or higher recommended) * Google Cloud Project with Gemini API enabled * Gemini API Key ---

Practical notes

  • Maintained by creating-cat.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
prompt(string, required) Text prompt for image generation. If input images are provided, include instructions on how to incorporate them into the generated image. Eng
output_directory(string, optional) Directory path where the generated image will be saved.
file_name(string, optional) Name of the saved image file (without extension).
input_image_paths(string\[], optional) List of file paths for input reference images.
use_enhanced_prompt(boolean, optional) Whether to use enhanced prompts to assist AI instructions.
target_image_max_size(number, optional) Maximum size (in pixels) for the longer edge after resizing. The aspect ratio is preserved.
force_conversion_type(string, optional) Optionally force conversion to a specific format ('jpeg', 'webp', 'png'). If not specified, the original format will be processed, defaulting
skip_compression_and_resizing(boolean, optional) Whether to skip compression and resizing of generated images. If true, force_conversion_type and target_image_max_size will be ignored.
jpeg_quality(number, optional) JPEG quality (0-100). Lower values result in higher compression.
webp_quality(number, optional) WebP quality (0-100). Lower values result in higher compression.
png_compression_level(number, optional) PNG compression level (0-9). Higher values result in higher compression.
optipng_optimization_level(number, optional) OptiPNG optimization level (0-7). Higher values result in higher compression.

How to install the Gemini Image MCP Server

{
  "mcpServers": {
    "gemini-image-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@creating-cat/gemini-image-mcp-server"
      ],
      "env": {
        "GEMINI_API_KEY": "YOUR_GEMINI_API_KEY"
      },
      "disabled": false,
      "timeout": 300
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Node.js (v18 or higher recommended) * Google Cloud Project with Gemini API enabled * Gemini API Key ---
VariableDescriptionRequired
GEMINI_API_KEYDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Gemini Image to prompt.”
  • “Use Gemini Image to output directory.”
  • “Use Gemini Image to file name.”

Frequently asked questions

An MCP server for image generation using the Gemini API. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.