
nanobanana
Standalone image generation using Nano Banana MCP server. Generates and edits images, icons, diagrams, patterns, and visual assets via Gemini image models. No Gemini CLI required.
- GitHub stars
- 30
Install
/plugin install nanobanana@cc-dev-toolsRun it inside Claude Code after adding the marketplace with /plugin marketplace add Lucklyric/cc-dev-tools.
Contents
Discovered from sourceSkills 1
Nano Banana Image Generation (MCP)
Generate and edit images directly via the Nano Banana MCP server tools. No Gemini CLI dependency.
Upstream reference: https://github.com/gemini-cli-extensions/nanobanana
When to Use This Skill
ALWAYS use this skill when the user:
- Asks for any image, graphic, illustration, or visual
- Wants a thumbnail, featured image, or banner
- Requests icons, diagrams, or patterns
- Asks to edit, modify, or restore a photo
- Uses words like: generate, create, make, draw, design, visualize
Do NOT attempt to generate images through any other method.
Health Check
Before first use, verify prerequisites:
- Node.js >= 18 — required to run the MCP server
- API key set —
GEMINI_API_KEYorNANOBANANA_API_KEYenvironment variable - MCP server available — the nanobanana MCP tools should appear in your tool list
If MCP tools are not available, the plugin may need reinstalling. See references/troubleshooting.md.
Tool Selection
| User Request | MCP Tool |
|---|---|
| "generate an image of..." | generate_image |
| "create an app icon" | generate_icon |
| "draw a flowchart of..." | generate_diagram |
| "fix this old photo" | restore_image |
| "edit this image" | edit_image |
| "create a repeating texture" | generate_pattern |
| "make a comic strip" | generate_story |
Quick Usage
Call the MCP tools directly with structured parameters:
Generate Images (default: 3 images)
Tool: generate_image
Parameters:
prompt: "a sunset over mountains, photorealistic"
outputCount: 3
Edit Existing Image
Tool: edit_image
Parameters:
prompt: "change the background to a beach scene"
file: "/absolute/path/to/image.jpg"
Generate App Icons
Tool: generate_icon
Parameters:
prompt: "coffee cup logo"
sizes: [64, 128, 256, 512]
type: "app-icon"
style: "modern"
corners: "rounded"
Generate Diagram
Tool: generate_diagram
Parameters:
prompt: "microservices architecture for e-commerce platform"
type: "architecture"
style: "professional"
complexity: "detailed"
For full parameter reference for all 7 tools, see references/commands.md.
Defaults
- File paths: Always resolve file paths to absolute paths before passing to any MCP tool. The MCP server runs in a different working directory, so relative paths will fail.
- outputCount: For
generate_image, always use 3 unless user specifies otherwise. Other tools have their own count semantics (e.g.,generate_iconusessizes,generate_storyusessteps). - Model:
gemini-3.1-flash-image-preview(override viaNANOBANANA_MODELenv var) - Output: Images saved to
./nanobanana-output/in current directory
Presenting Results
After generation completes:
- List contents of
./nanobanana-output/to find generated files - Present the most recent image(s) to the user using the Read tool
- Offer to regenerate with variations if needed
Refinements and Iterations
When the user asks for changes:
- "Try again" / "Give me options": Call
generate_imageagain withoutputCount: 3 - "Make it more [adjective]": Adjust prompt and regenerate
- "Edit this one": Call
edit_imagewith the file path and edit instructions - "Different style": Add style to the
stylesarray parameter
Prompt Tips
- Be specific: Include style, mood, colors, composition details
- Add "no text": If you don't want text rendered in the image
- Reference styles: "editorial photography", "flat illustration", "3D render", "watercolor"
- Specify aspect ratio: Include "wide 16:9" or "square" in the prompt description
For image quality guidelines (style compliance, text accuracy, story consistency), see references/generation-guidelines.md.
For error troubleshooting, see references/troubleshooting.md.
Commands 8
Nano Banana: Generate Diagram
Parse the user's input and call the generate_diagram MCP tool.
Arguments
User input: $ARGUMENTS
Instructions
- Extract the main prompt (text before any options, required)
- Parse any options:
--type=flowchart|architecture|network|database|wireframe|mindmap|sequence→ maps totype(default: flowchart)--style=professional|clean|hand-drawn|technical→ maps tostyle(default: professional)--layout=horizontal|vertical|hierarchical|circular→ maps tolayout(default: hierarchical)--complexity=simple|detailed|comprehensive→ maps tocomplexity(default: detailed)--colors=mono|accent|categorical→ maps tocolors(default: accent)--annotations=minimal|detailed→ maps toannotations(default: detailed)
- If any options are invalid, tell the user and list valid values
- Call
generate_diagramwith the parsed parameters - After generation, present the diagram to the user using the Read tool
Examples
/diagram user authentication flow
/diagram microservices architecture for e-commerce --type=architecture --complexity=comprehensive
/diagram database schema for blog platform --type=database --style=clean
Nano Banana: Edit Image
Parse the user's input and call the edit_image MCP tool.
Arguments
User input: $ARGUMENTS
Instructions
- Extract the filename (first argument, required)
- Extract the edit prompt (remaining text after filename, required)
- If either is missing, show usage:
/edit <filename> <edit instructions> - Resolve the filename to an absolute path before passing to the MCP tool
- Call
edit_imagewith:file: the absolute file pathprompt: the edit instructions
- After editing, present the result image to the user using the Read tool
Examples
/edit photo.jpg change the background to a beach scene
/edit ./nanobanana-output/sunset.png make the colors more vibrant
/edit logo.png add a shadow effect
Nano Banana: Generate Image
Parse the user's input and call the generate_image MCP tool.
Arguments
User input: $ARGUMENTS
Instructions
- Extract the main prompt (text before any options)
- Parse any options from the input:
--count=N(1-8, default: 3) → maps tooutputCount--styles="style1,style2"→ maps tostylesarray. Valid: photorealistic, watercolor, oil-painting, sketch, pixel-art, anime, vintage, modern, abstract, minimalist--variations="var1,var2"→ maps tovariationsarray. Valid: lighting, angle, color-palette, composition, mood, season, time-of-day--format=grid|separate→ maps toformat(default: separate)--seed=123→ maps toseed(integer)
- If any options are invalid, tell the user what's wrong and list the valid options
- Call
generate_imagewith the parsed parameters. DefaultoutputCountto 3 if not specified. - After generation, list the contents of
./nanobanana-output/and present the most recent image(s) to the user using the Read tool
Examples
/generate a sunset over mountains, photorealistic
/generate a cute robot mascot --count=5 --styles="pixel-art,modern"
/generate abstract wallpaper --variations="color-palette,mood" --count=2
Nano Banana: Generate Icon
Parse the user's input and call the generate_icon MCP tool.
Arguments
User input: $ARGUMENTS
Instructions
- Extract the main prompt (text before any options, required)
- Parse any options:
--sizes="16,32,64"→ maps tosizesarray. Valid sizes: 16, 32, 64, 128, 256, 512, 1024--type=app-icon|favicon|ui-element→ maps totype(default: app-icon)--style=flat|skeuomorphic|minimal|modern→ maps tostyle(default: modern)--format=png|jpeg→ maps toformat(default: png)--background=transparent|white|black→ maps tobackground(default: transparent)--corners=rounded|sharp→ maps tocorners(default: rounded)
- If any options are invalid, tell the user and list valid values
- Call
generate_iconwith the parsed parameters - After generation, present the icon(s) to the user using the Read tool
Examples
/icon coffee cup logo
/icon rocket ship app icon --sizes="64,128,256,512" --style=flat
/icon settings gear --type=ui-element --corners=sharp --background=white
Nano Banana: Natural Language Image Generation
Analyze the user's request and route to the most appropriate MCP tool.
Arguments
User input: $ARGUMENTS
Instructions
Analyze the user's natural language request and determine the best tool:
| Intent | Tool |
|---|---|
| Generate single/multiple images | generate_image |
| Edit an existing image | edit_image |
| Restore/enhance a photo | restore_image |
| Create app icons, favicons, UI elements | generate_icon |
| Create seamless patterns, textures | generate_pattern |
| Create visual stories, sequences | generate_story |
| Create technical diagrams, flowcharts | generate_diagram |
- Parse the natural language request to identify intent and parameters
- Select the most specialized tool for the request
- If the request references a file, resolve it to an absolute path before passing to the MCP tool
- Call the tool with appropriate parameters
- For
generate_image, defaultoutputCountto 3 unless specified otherwise - After generation, present the result(s) to the user using the Read tool
Examples
/nanobanana create 3 variations of a mountain landscape at sunset
/nanobanana edit photo.jpg to add a rainbow in the sky
/nanobanana design a mobile app icon for a fitness tracker
/nanobanana draw a flowchart for CI/CD pipeline
/nanobanana make a comic strip about a cat learning to code
Nano Banana: Generate Pattern
Parse the user's input and call the generate_pattern MCP tool.
Arguments
User input: $ARGUMENTS
Instructions
- Extract the main prompt (text before any options, required)
- Parse any options:
--size="WxH"→ maps tosize(e.g., 128x128, 256x256, 512x512; default: 256x256)--type=seamless|texture|wallpaper→ maps totype(default: seamless)--style=geometric|organic|abstract|floral|tech→ maps tostyle(default: abstract)--density=sparse|medium|dense→ maps todensity(default: medium)--colors=mono|duotone|colorful→ maps tocolors(default: colorful)--repeat=tile|mirror→ maps torepeat(default: tile)
- If any options are invalid, tell the user and list valid values
- Call
generate_patternwith the parsed parameters - After generation, present the pattern to the user using the Read tool
Examples
/pattern Japanese wave motif
/pattern geometric hexagons --style=tech --colors=mono --density=dense
/pattern floral vintage wallpaper --type=wallpaper --style=floral --size="512x512"
Nano Banana: Restore Image
Parse the user's input and call the restore_image MCP tool.
Arguments
User input: $ARGUMENTS
Instructions
- Extract the filename (first argument, required)
- Extract the restoration prompt (remaining text after filename, required)
- If either is missing, show usage:
/restore <filename> <restoration instructions> - Resolve the filename to an absolute path before passing to the MCP tool
- Call
restore_imagewith:file: the absolute file pathprompt: the restoration instructions
- After restoration, present the result image to the user using the Read tool
Examples
/restore old_photo.jpg enhance and remove scratches
/restore damaged.png fix the torn edges and improve clarity
/restore faded.jpg restore original colors and sharpness
Nano Banana: Generate Story
Parse the user's input and call the generate_story MCP tool.
Arguments
User input: $ARGUMENTS
Instructions
- Extract the main prompt (text before any options, required)
- Parse any options:
--steps=N→ maps tosteps(2-8, default: 4)--type=story|process|tutorial|timeline→ maps totype(default: story)--style=consistent|evolving→ maps tostyle(default: consistent)--layout=separate|grid|comic→ maps tolayout(default: separate)--transition=smooth|dramatic|fade→ maps totransition(default: smooth)--format=storyboard|individual→ maps toformat(default: individual)
- If any options are invalid, tell the user and list valid values
- Call
generate_storywith the parsed parameters - After generation, present all story frames to the user using the Read tool
Examples
/story a day in the life of a robot barista
/story how to make sushi --type=tutorial --steps=6
/story seasons changing in a garden --style=evolving --transition=fade
MCP servers 1
Sponsors
Details
- Marketplace
- Lucklyric/cc-dev-tools
- Source
- plugins/nanobanana
- Category
- Community