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-tools

Run it inside Claude Code after adding the marketplace with /plugin marketplace add Lucklyric/cc-dev-tools.

Contents

Discovered from source

Skills 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:

  1. Node.js >= 18 — required to run the MCP server
  2. API key set — GEMINI_API_KEY or NANOBANANA_API_KEY environment variable
  3. 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 RequestMCP 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_icon uses sizes, generate_story uses steps).
  • Model: gemini-3.1-flash-image-preview (override via NANOBANANA_MODEL env var)
  • Output: Images saved to ./nanobanana-output/ in current directory

Presenting Results

After generation completes:

  1. List contents of ./nanobanana-output/ to find generated files
  2. Present the most recent image(s) to the user using the Read tool
  3. Offer to regenerate with variations if needed

Refinements and Iterations

When the user asks for changes:

  • "Try again" / "Give me options": Call generate_image again with outputCount: 3
  • "Make it more [adjective]": Adjust prompt and regenerate
  • "Edit this one": Call edit_image with the file path and edit instructions
  • "Different style": Add style to the styles array parameter

Prompt Tips

  1. Be specific: Include style, mood, colors, composition details
  2. Add "no text": If you don't want text rendered in the image
  3. Reference styles: "editorial photography", "flat illustration", "3D render", "watercolor"
  4. 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

  1. Extract the main prompt (text before any options, required)
  2. Parse any options:
    • --type=flowchart|architecture|network|database|wireframe|mindmap|sequence → maps to type (default: flowchart)
    • --style=professional|clean|hand-drawn|technical → maps to style (default: professional)
    • --layout=horizontal|vertical|hierarchical|circular → maps to layout (default: hierarchical)
    • --complexity=simple|detailed|comprehensive → maps to complexity (default: detailed)
    • --colors=mono|accent|categorical → maps to colors (default: accent)
    • --annotations=minimal|detailed → maps to annotations (default: detailed)
  3. If any options are invalid, tell the user and list valid values
  4. Call generate_diagram with the parsed parameters
  5. 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

  1. Extract the filename (first argument, required)
  2. Extract the edit prompt (remaining text after filename, required)
  3. If either is missing, show usage: /edit <filename> <edit instructions>
  4. Resolve the filename to an absolute path before passing to the MCP tool
  5. Call edit_image with:
    • file: the absolute file path
    • prompt: the edit instructions
  6. 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

  1. Extract the main prompt (text before any options)
  2. Parse any options from the input:
    • --count=N (1-8, default: 3) → maps to outputCount
    • --styles="style1,style2" → maps to styles array. Valid: photorealistic, watercolor, oil-painting, sketch, pixel-art, anime, vintage, modern, abstract, minimalist
    • --variations="var1,var2" → maps to variations array. Valid: lighting, angle, color-palette, composition, mood, season, time-of-day
    • --format=grid|separate → maps to format (default: separate)
    • --seed=123 → maps to seed (integer)
  3. If any options are invalid, tell the user what's wrong and list the valid options
  4. Call generate_image with the parsed parameters. Default outputCount to 3 if not specified.
  5. 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

  1. Extract the main prompt (text before any options, required)
  2. Parse any options:
    • --sizes="16,32,64" → maps to sizes array. Valid sizes: 16, 32, 64, 128, 256, 512, 1024
    • --type=app-icon|favicon|ui-element → maps to type (default: app-icon)
    • --style=flat|skeuomorphic|minimal|modern → maps to style (default: modern)
    • --format=png|jpeg → maps to format (default: png)
    • --background=transparent|white|black → maps to background (default: transparent)
    • --corners=rounded|sharp → maps to corners (default: rounded)
  3. If any options are invalid, tell the user and list valid values
  4. Call generate_icon with the parsed parameters
  5. 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:

IntentTool
Generate single/multiple imagesgenerate_image
Edit an existing imageedit_image
Restore/enhance a photorestore_image
Create app icons, favicons, UI elementsgenerate_icon
Create seamless patterns, texturesgenerate_pattern
Create visual stories, sequencesgenerate_story
Create technical diagrams, flowchartsgenerate_diagram
  1. Parse the natural language request to identify intent and parameters
  2. Select the most specialized tool for the request
  3. If the request references a file, resolve it to an absolute path before passing to the MCP tool
  4. Call the tool with appropriate parameters
  5. For generate_image, default outputCount to 3 unless specified otherwise
  6. 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

  1. Extract the main prompt (text before any options, required)
  2. Parse any options:
    • --size="WxH" → maps to size (e.g., 128x128, 256x256, 512x512; default: 256x256)
    • --type=seamless|texture|wallpaper → maps to type (default: seamless)
    • --style=geometric|organic|abstract|floral|tech → maps to style (default: abstract)
    • --density=sparse|medium|dense → maps to density (default: medium)
    • --colors=mono|duotone|colorful → maps to colors (default: colorful)
    • --repeat=tile|mirror → maps to repeat (default: tile)
  3. If any options are invalid, tell the user and list valid values
  4. Call generate_pattern with the parsed parameters
  5. 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

  1. Extract the filename (first argument, required)
  2. Extract the restoration prompt (remaining text after filename, required)
  3. If either is missing, show usage: /restore <filename> <restoration instructions>
  4. Resolve the filename to an absolute path before passing to the MCP tool
  5. Call restore_image with:
    • file: the absolute file path
    • prompt: the restoration instructions
  6. 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

  1. Extract the main prompt (text before any options, required)
  2. Parse any options:
    • --steps=N → maps to steps (2-8, default: 4)
    • --type=story|process|tutorial|timeline → maps to type (default: story)
    • --style=consistent|evolving → maps to style (default: consistent)
    • --layout=separate|grid|comic → maps to layout (default: separate)
    • --transition=smooth|dramatic|fade → maps to transition (default: smooth)
    • --format=storyboard|individual → maps to format (default: individual)
  3. If any options are invalid, tell the user and list valid values
  4. Call generate_story with the parsed parameters
  5. 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

More from Lucklyric/cc-dev-tools

All 4