Skip to main content
Glama
vipincr

Imagen MCP Server

by vipincr
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

šŸŽØ Imagen MCP Server

License: MIT Python 3.9+ MCP

A high-quality Model Context Protocol (MCP) server that enables AI assistants to generate images using Google's Gemini and Imagen models.

šŸ“– Overview

Imagen MCP provides AI-powered image generation capabilities to any MCP-compatible client (such as Claude Desktop, VS Code with GitHub Copilot, or custom applications). It connects to Google's AI platform to provide access to cutting-edge image generation models.

Why Use This MCP Server?

  • šŸ”„ Dynamic Model Selection: Query available models and choose the best one for your needs

  • šŸ–¼ļø High-Quality Output: Access to Gemini and Imagen models for 2K/4K resolution images

  • šŸ“ Flexible Aspect Ratios: Support for multiple aspect ratios (1:1, 16:9, 9:16, etc.)

  • šŸ”¤ Text Rendering: Strong text-in-image rendering with Gemini models

  • ļæ½ļæ½ Secure Configuration: API keys stored securely via environment variables

  • šŸš€ Easy Integration: Works with any MCP-compatible AI assistant

  • šŸ“¦ Minimal Dependencies: Only requires fastmcp - all other functionality uses Python standard library

āœØ Features

Tool

Description

check_api_status

Verify API key configuration and connectivity

list_image_models

Discover available image generation models

set_image_model

Select which model to use for generation

get_current_image_model

Check which model is currently selected

generate_image_from_prompt

Generate images from text descriptions

save_image_to_file

Save generated images to the filesystem

generate_and_save_image

Generate and save in a single operation

šŸ”§ Prerequisites

  • Python 3.9+ (uses standard library features available in 3.9+)

  • Google AI API Key (Get one here)

  • An MCP-compatible client (Claude Desktop, VS Code with Copilot, etc.)

šŸš€ Quick Start

1. Clone the Repository

git clone https://github.com/yourusername/imagen-mcp.git cd imagen-mcp

2. Install Dependencies

pip install -r requirements.txt

Or using a virtual environment (recommended):

python -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate pip install -r requirements.txt

3. Configure API Key

Create a .env file in the project root:

GOOGLE_AI_API_KEY=your_google_ai_api_key_here

Or set it as an environment variable directly in your MCP client configuration.

šŸ’” Tip: Get your API key from Google AI Studio

4. Test the Server

python run_server.py

āš™ļø Configuration

Environment Variables

Variable

Description

Required

GOOGLE_AI_API_KEY

Google AI API key

āœ… Yes

IMAGEN_MODEL_ID

Default model to use (defaults to

gemini-3-pro-image-preview

)

āŒ No

Model selection fallback (highest priority first): explicit tool parameter āžœ runtime set_image_model āžœ IMAGEN_MODEL_ID env var āžœ built-in default gemini-3-pro-image-preview.

Supported Aspect Ratios

Aspect Ratio

Use Case

1:1

Social media posts, profile pictures

3:2

,

2:3

Photography, prints

4:3

,

3:4

Traditional displays

4:5

,

5:4

Instagram posts

16:9

,

9:16

Widescreen, mobile stories

21:9

Ultra-wide, cinematic

Note: Not all models support all aspect ratios. The server will automatically retry without aspect ratio if not supported.

šŸ”Œ MCP Client Integration

Claude Desktop

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{ "mcpServers": { "imagen": { "command": "python", "args": ["/absolute/path/to/imagen-mcp/run_server.py"], "env": { "GOOGLE_AI_API_KEY": "your_api_key_here" } } } }

VS Code with GitHub Copilot

Add to your VS Code MCP settings (.vscode/mcp.json or user settings):

{ "servers": { "imagen": { "command": "python", "args": ["${workspaceFolder}/run_server.py"], "env": { "GOOGLE_AI_API_KEY": "your_api_key_here" } } } }

Or run the VS Code command: MCP: Open User Configuration and add the server.

Using with uv (Recommended for Isolation)

If you have uv installed:

{ "mcpServers": { "imagen": { "command": "uv", "args": ["run", "--directory", "/path/to/imagen-mcp", "python", "run_server.py"], "env": { "GOOGLE_AI_API_KEY": "your_api_key_here" } } } }

šŸ“š Tools Reference

check_api_status

Verify that your API key is configured and working.

Parameters: None

Returns:

{ "success": true, "api_key_configured": true, "api_key_valid": true, "total_models": 25, "image_models": 3, "current_model": "gemini-3-pro-image-preview" }

list_image_models

Discover available image generation models for your API key.

Parameters: None

Returns:

{ "success": true, "models": [ { "name": "gemini-3-pro-image-preview", "display_name": "Gemini 3 Pro (Image Preview)", "description": "Fast image generation model..." } ], "current_model": null, "count": 3 }

set_image_model

Select which model to use for image generation.

Parameters:

Parameter

Type

Required

Description

model_name

string

āœ…

Model ID from

list_image_models

Returns:

{ "success": true, "model": "gemini-3-pro-image-preview", "message": "Model set to 'gemini-3-pro-image-preview'. Ready for image generation." }

generate_image_from_prompt

Generate an image from a text description.

Parameters:

Parameter

Type

Required

Description

prompt

string

āœ…

Detailed text description of the image

aspect_ratio

string

āŒ

One of the supported aspect ratios

model

string

āŒ

Override the current model

Returns:

{ "success": true, "image_base64": "iVBORw0KGgo...", "mime_type": "image/png", "extension": ".png", "size_bytes": 1234567, "model_used": "gemini-3-pro-image-preview" }

save_image_to_file

Save a base64-encoded image to a file.

Parameters:

Parameter

Type

Required

Description

image_base64

string

āœ…

Base64-encoded image data

output_path

string

āœ…

File path to save the image

Returns:

{ "success": true, "saved_path": "/absolute/path/to/image.png", "size_bytes": 1234567 }

generate_and_save_image

Generate an image and save it to a file in one operation.

Parameters:

Parameter

Type

Required

Description

prompt

string

āœ…

Detailed text description of the image

output_path

string

āœ…

File path to save the image

aspect_ratio

string

āŒ

One of the supported aspect ratios

model

string

āŒ

Override the current model

Returns:

{ "success": true, "saved_path": "/absolute/path/to/image.png", "mime_type": "image/png", "size_bytes": 1234567, "model_used": "gemini-3-pro-image-preview" }

šŸ’” Usage Examples

Once the server is connected to your AI assistant, you can use natural language:

First-Time Setup

"Check if my API key is configured correctly" "List available image generation models" "Set the model to gemini-2.0-flash-exp-image-generation"

Basic Image Generation

"Generate a sunset over mountains with vibrant orange and purple colors"

Product Photography

"Create a product shot of a smartwatch on a minimalist white surface with dramatic lighting"

Specific Dimensions

"Generate a 16:9 banner image for a tech blog featuring abstract circuit patterns"

Save to Project

"Generate a hero image for my website and save it to assets/images/hero.png"

šŸ—ļø Project Structure

imagen-mcp/ ā”œā”€ā”€ image_generator/ ā”‚ ā”œā”€ā”€ __init__.py # Package initialization ā”‚ ā”œā”€ā”€ core.py # Core image generation & model listing logic ā”‚ ā””ā”€ā”€ server.py # MCP server implementation with tools ā”œā”€ā”€ run_server.py # Server entry point ā”œā”€ā”€ run_with_venv.sh # Helper script for venv ā”œā”€ā”€ requirements.txt # Python dependencies (minimal) ā”œā”€ā”€ .env.example # Example environment configuration ā”œā”€ā”€ LICENSE # MIT License ā”œā”€ā”€ README.md # This file ā””ā”€ā”€ CONTRIBUTING.md # Contribution guidelines

šŸ›”ļø Security Considerations

  • API Key Protection: Never commit your API key. Use environment variables or .env files

  • Secure Storage: The .env file is included in .gitignore by default

  • MCP Configuration: API keys can be passed securely via MCP client env configuration

  • File System Access: Be mindful of where images are saved

šŸ” Troubleshooting

Common Issues

"Missing API key" error

  • Ensure GOOGLE_AI_API_KEY is set in your environment or .env file

  • Check that the .env file is in the project root directory

  • Verify the key is passed in your MCP client configuration

"No model selected" error

  • Use list_image_models to see available models

  • Use set_image_model to select one before generating

"Aspect ratio is not enabled" error

  • The server automatically retries without aspect ratio

  • Some models don't support custom aspect ratios

No image models found

  • Your API key may not have access to image generation models

  • Check your Google AI Studio account for API access

Connection issues with MCP client

  • Verify the path in your MCP configuration is absolute

  • Check that Python is in your system PATH

  • Ensure all dependencies are installed

Debugging

Check your MCP client's logs:

  • Claude Desktop: Check the application logs

  • VS Code: View Output panel ā†’ MCP

šŸ¤ Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Ways to Contribute

  • šŸ› Report bugs and issues

  • šŸ’” Suggest new features

  • šŸ“– Improve documentation

  • šŸ”§ Submit pull requests

šŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

MIT License Copyright (c) 2025 Vipin Ravindran Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

šŸ™ Acknowledgments

šŸ“¬ Support

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/vipincr/imagen-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server