generate_imagesLABSCO SUMMARY
Imagen 3.0 with the file handling already done.
The generation is Google's; what is added is everything after it. Images land on disk with collision-free names and an HTML wrapper you can open, so a batch of four is browsable instead of four blobs in a transcript.
What it is
A TypeScript server in front of Google's Imagen 3.0 model, reached through the Gemini API. It generates images, writes each to a local images directory under a filename built from the sanitized prompt plus a timestamp, and can emit HTML preview tags pointing at those files.
What you get
- generate_images takes a prompt and an optional count from 1 to 4, and returns that many images from Imagen 3.0.
- Files are written locally as PNGs, named from the sanitized prompt and a timestamp, so a batch never overwrites the last one and a week-old render is still identifiable.
- create_image_html turns a list of image paths into HTML tags with absolute file:// URLs, at a width and height you choose — 512 by 512 unless you say otherwise.
- MIT-licensed TypeScript you run yourself, with two named error codes for a tool that is missing and for a generation that failed.
Requirements
Node.js 18 or higher and a Google Gemini API key, passed to the server as an environment variable. There is no published package to launch: clone the repository, run the build, and point your client at the built entry file. The README names an absolute Windows path for the output directory, so check where your images actually land before wiring anything to that location.
Setup effort
Build from source — git clone https://github.com/falahgs/imagen-3.0-generate-google-mcp-server.git
USE CASES
01
Producing a set of options for one brief
Ask for up to four images in a single request and compare them, rather than re-prompting one at a time.
02
Keeping generated art findable later
Every image is written with the prompt and a timestamp in its filename, so a render from last week is still identifiable on disk.
03
Reviewing a batch in a browser
Turn the generated file paths into HTML tags at the width and height you want, and open the result locally.
2 tools
Listed in project docs. Your client may show a different list.
create_image_htmlBEFORE YOU INSTALL
What to know first
Tools you get
2 tools named in the project's documentation.
Requires
- node on PATH
- Node.js 18 or higher
- GEMINI_API_KEY in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone and build this one yourself.
Server setup
TERMINAL
git clone https://github.com/falahgs/imagen-3.0-generate-google-mcp-server.git
cd imagen-3.0-generate-google-mcp-server
npm install
npm run buildMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"gemini-image-gen": {
"command": "node",
"args": [
"<YOUR_PATH_TO_PROJECT_DIRECTORY>/build/index.js"
],
"cwd": "<YOUR_PATH_TO_PROJECT_DIRECTORY>",
"env": {
"GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>"
}
}
}
}<YOUR_PATH_TO_PROJECT_DIRECTORY> is the full path to your clone, in args as well as cwd.
