generate_image
Generates an image based on a prompt and saves it to the specified path.
LABSCO SUMMARY
The argument list carries more about the file than about the picture, which is what separates this from a generate-and-return-bytes server.
jpeg_quality, webp_quality, png_compression_level, optipng_optimization_level and target_image_max_size all shape what is written to disk, and skip_compression_and_resizing turns that stage off in one flag — so the image arrives already sized for wherever it is going, rather than needing a second pass. The vendor's description of the tool is a single sentence, which makes the argument list the real documentation. With a single tool there is no call ordering to learn.
What it is
A single-tool image generation server: generate_image takes a prompt and saves the result into output_directory under file_name.
What you get
- A single call that generates the image and writes the file:
promptcarries the request,output_directoryandfile_namedecide where it goes. - Output handling in the same arguments:
force_conversion_typefor the format,jpeg_quality,webp_quality,png_compression_levelandoptipng_optimization_levelfor the encoders,target_image_max_sizefor the ceiling, andskip_compression_and_resizingto bypass that stage. input_image_pathsfor sending existing images along with the request, anduse_enhanced_promptfor switching prompt enhancement on.
Requirements
A Gemini API key, supplied as GEMINI_API_KEY, and a writable output_directory for the file the call produces.
Setup effort
One command plus a key — npx -y @creating-cat/gemini-image-mcp-server, then supply credentials
USE CASES
01
Producing an image already sized and encoded for where it is going
Describe the image, name the directory and filename it should land in, and set the format and quality in the same call so nothing needs a second pass.
1 tool
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
BEFORE YOU INSTALL
What to know first
Tools you get
1 tool when we connected. Names like output_directory and jpeg_quality are parameters of generate_image, which saves every image to disk.
Requires
- npx on PATH
- Node.js
- GEMINI_API_KEY in your environment
Where it runs
The documented client runs the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the one tool definition that rides along on every turn
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y @creating-cat/gemini-image-mcp-serverMCP Clients
Roo Code
ROO CODE · JSON
{
"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
}
}
}
