mrn-gemini-imagen-mcp
Generates and edits images using the Google Gemini API, supporting text-to-image generation, image editing, and multi-turn iterative refinement.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mrn-gemini-imagen-mcp generate a serene Japanese garden with koi pond"
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.
mrn-gemini-imagen-mcp
MCP (Model Context Protocol) server for generating and editing images using Google Gemini API.
Quick Start
Get your API key from Google AI Studio
Add to Claude Desktop config:
{
"mcpServers": {
"gemini-imagen": {
"command": "npx",
"args": ["-y", "mrn-gemini-imagen-mcp"],
"env": { "GEMINI_API_KEY": "your-api-key-here" }
}
}
}Restart Claude Desktop and start generating images!
Related MCP server: Nano-Banana MCP Server
Features
Text-to-Image Generation: Generate images from text descriptions
Image Editing: Modify existing images based on text prompts
Multi-turn Iteration: Refine images through conversational editing sessions
Configurable Aspect Ratios: Support for 10 different aspect ratios
Flexible Model Selection: Use any Gemini image model via configuration
Prerequisites
Node.js >= 18.0.0
Google Gemini API Key (get one from Google AI Studio)
Installation
Option 1: Using npx (Recommended)
No installation needed! Just configure Claude Desktop or Claude Code to use it directly via npx.
Option 2: Global Install
npm install -g mrn-gemini-imagen-mcpOption 3: From Source
git clone https://github.com/mernorthzide/mrn-gemini-imagen-mcp.git
cd mrn-gemini-imagen-mcp
npm install
npm run buildConfiguration
Set the following environment variables:
Variable | Required | Default | Description |
| Yes | - | Your Google Gemini API key |
| No |
| Gemini model to use |
| No |
| Output directory for images |
Supported Models
gemini-3-pro-image-preview(default, latest)gemini-2.5-flash-image(stable, faster)
Supported Aspect Ratios
1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
Note: Aspect ratio is optional. If not specified, Gemini will automatically select the best aspect ratio based on your prompt.
Usage with Claude Desktop
Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
Using npx (Recommended)
{
"mcpServers": {
"gemini-imagen": {
"command": "npx",
"args": ["-y", "mrn-gemini-imagen-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key-here"
}
}
}
}Using Global Install
{
"mcpServers": {
"gemini-imagen": {
"command": "mrn-gemini-imagen-mcp",
"env": {
"GEMINI_API_KEY": "your-api-key-here"
}
}
}
}Usage with Claude Code
Add to your Claude Code settings file (~/.claude.json):
{
"mcpServers": {
"gemini-imagen": {
"type": "stdio",
"command": "npx",
"args": ["-y", "mrn-gemini-imagen-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key-here"
}
}
}
}Tip: Set
GEMINI_MODELtogemini-2.5-flash-imagefor faster generation.
Tools
1. generate_image
Generate an image from a text description.
Parameters:
Parameter | Type | Required | Description |
| string | Yes | Description of the image to generate |
| string | No | Aspect ratio (auto-selected by Gemini if not provided) |
| string | No | Custom output file path |
Example:
{
"prompt": "A serene Japanese garden with a koi pond and cherry blossoms",
"aspectRatio": "16:9"
}Response:
{
"success": true,
"filePath": "/path/to/a_serene_japanese_garden_1705123456789.png",
"message": "Image generated successfully"
}2. edit_image
Edit an existing image based on a text prompt.
Parameters:
Parameter | Type | Required | Description |
| string | Yes | Path to the image to edit |
| string | Yes | Instructions for editing |
| string | No | Aspect ratio for output |
| string | No | Custom output file path |
Example:
{
"imagePath": "/path/to/original.png",
"prompt": "Change the sky to a beautiful sunset with orange and pink colors"
}3. iterate_image
Iteratively refine an image through multi-turn conversation.
Parameters:
Parameter | Type | Required | Description |
| string | Yes | Instructions for this iteration |
| string | No | Session ID from previous iteration |
| string | Conditional | Required when starting new session |
| string | No | Aspect ratio for output |
Starting a new session:
{
"imagePath": "/path/to/original.png",
"prompt": "Add a rainbow in the background"
}Response:
{
"success": true,
"filePath": "/path/to/add_a_rainbow_1705123456789.png",
"sessionId": "550e8400-e29b-41d4-a716-446655440000",
"message": "Image iteration completed. Use the same sessionId to continue editing."
}Continuing the session:
{
"sessionId": "550e8400-e29b-41d4-a716-446655440000",
"prompt": "Make the rainbow more vibrant and add some birds"
}Error Handling
All tools return structured error responses when something goes wrong:
{
"success": false,
"error": {
"code": "SAFETY_BLOCKED",
"message": "Content was blocked by safety filters",
"reason": "HARM_CATEGORY_DANGEROUS_CONTENT"
}
}Error Codes:
Code | Description |
| Content blocked by safety filters |
| Error from Gemini API |
| Invalid input parameters |
| File read/write error |
Development
# Watch mode for development
npm run dev
# Build for production
npm run build
# Run the server directly
npm startFile Structure
mrn-gemini-imagen-mcp/
├── src/
│ ├── index.ts # MCP server entry point
│ ├── types.ts # TypeScript types and constants
│ ├── services/
│ │ └── geminiClient.ts # Gemini API wrapper
│ ├── tools/
│ │ ├── generateImage.ts # Text-to-image tool
│ │ ├── editImage.ts # Image editing tool
│ │ └── iterateImage.ts # Multi-turn iteration tool
│ └── utils/
│ ├── fileManager.ts # File operations
│ └── sessionManager.ts # Session management
├── dist/ # Compiled JavaScript
├── package.json
├── tsconfig.json
└── README.mdLicense
MIT
Acknowledgments
Available Tools
3 toolsedit_imageA
Edit an existing image based on a text prompt using Google Gemini. Useful for modifying specific parts of an image while preserving others.
Inputs: prompt (required), imagePath (required), outputPath, aspectRatio.
generate_imageB
Generate an image from a text description using Google Gemini. Returns the file path of the generated image.
Inputs: prompt (required), outputPath, aspectRatio.
iterate_imageB
Iteratively refine an image through multi-turn conversation. Start a new session with an image, or continue an existing session to make incremental adjustments.
Inputs: prompt (required), imagePath, sessionId, aspectRatio.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clear, distinct purpose: generate creates new images, edit modifies existing ones with a single prompt, and iterate enables multi-turn refinement. The descriptions make the boundaries unambiguous.
All tool names follow a consistent verb_noun pattern in snake_case (generate_image, edit_image, iterate_image), making them easy to understand and predict.
Three tools is an ideal size for this domain—covering creation, editing, and iterative refinement without redundancy or unnecessary bloat.
The tool surface fully covers the core image manipulation workflow: generate from scratch, edit with a prompt, and iteratively refine through conversation. No obvious gaps for the intended purpose.
Maintenance
Related MCP Connectors
MCP server for Qwen Image 3 AI image generation
MCP server for Google Veo AI video generation
MCP server for Midjourney AI image generation and editing
MCP server for Flux AI image generation
Related MCP Servers
- AlicenseBqualityDmaintenanceAn MCP server for image generation using the Gemini API.1160 npm2MIT
- AlicenseAqualityDmaintenanceAn MCP server that provides AI image generation and editing capabilities using Google's Gemini 2.5 Flash Image API. It allows users to create new images from text, modify existing files, and perform iterative edits through natural language prompts.61,708 npmMIT
- AlicenseBqualityDmaintenanceMCP server for generating images and audio using Google's Gemini AI models.272 PyPI2MIT
- AlicenseAqualityCmaintenanceMCP server for Google Gemini image generation with configurable model support, enabling text-to-image generation, image editing, and iterative refinement.640MIT