nano-banana-mcp
An MCP (Model Context Protocol) server for generating images using Google's Gemini image generation model.
Installation
uv syncConfiguration
Set one of the following authentication methods:
Option 1: Gemini API Key
export GEMINI_API_KEY="your-api-key"Option 2: Vertex AI
export VERTEX_PROJECT="your-project-id"
export VERTEX_LOCATION="us-central1" # optional, defaults to us-central1MCP Tools
generate_to_file
Generate an image and save it to a file.
Parameters:
prompt(string): The prompt describing the image to generatesave_path(string): The file path where the image should be saved
Returns:
{
"path": "/absolute/path/to/image.png",
"message": "Image generated successfully"
}generate_to_data_url
Generate an image and return it as a base64 data URL.
Parameters:
prompt(string): The prompt describing the image to generate
Returns:
{
"data_url": "data:image/png;base64,iVBORw0KGgo...",
"message": "Image generated successfully"
}MCP Client Configuration
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"nano-banana-mcp": {
"command": "uvx",
"args": ["git+https://github.com/ipfans/nano-banana-mcp.git"],
"cwd": "/path/to/nano-banana-mcp",
"env": {
"GEMINI_API_KEY": "<your-api-key>"
}
}
}
}Claude Code
Add to your .mcp.json:
{
"mcpServers": {
"nano-banana-mcp": {
"command": "uvx",
"args": ["git+https://github.com/ipfans/nano-banana-mcp.git"],
"cwd": "/path/to/nano-banana-mcp",
"env": {
"GEMINI_API_KEY": "<your-api-key>"
}
}
}
}License
MIT
