nano-banana

Generate and edit images with Google Gemini image models via MCP servers.

1|Updated May 6, 2026
One-click install
npx skills add https://github.com/surfingalien/FinSurfing --skill nano-banana-surfingalien
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nano-banana
Source: https://github.com/surfingalien/FinSurfing/tree/main/.claude/skills/nano-banana
Command: npx skills add https://github.com/surfingalien/FinSurfing --skill nano-banana-surfingalien

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires nanobanana-mcp, and includes references (resource) components.

What problem does it solve? Creating high-quality AI images with accurate text rendering, consistent characters, and reproducible results is difficult with plain prompts. This Skill connects Claude to Google's Gemini image models (Nano Banana series) through MCP, providing structured prompting workflows for marketing assets, UI mockups, and diagrams. ## Core Features & Use Cases - Image Generation & Editing: Create 4K images from text prompts, edit existing photos, and iteratively refine results using gemini_generate_image, gemini_edit_image, and continue_editing MCP tools. - Precision JSON Prompting: Translate plain-English briefs into structured JSON schemas (marketing_image, ui_builder, diagram_spec) that enable scoped edits—change lighting or camera angle without regenerating the entire scene. - Character Consistency & Text Rendering: Maintain the same character across multiple images using session history references, and render accurate in-image text for posters, logos, and infographics. - Use Case: A marketer needs a hero shot for a new beverage can. Describe the product in plain English, answer a few clarifying questions, receive a structured JSON spec, render it at 4K, then A/B test lighting variations by editing single JSON fields. ## Quick Start Ask Claude to generate a 4K image of your subject with a detailed description of style, lighting, and composition after configuring the nanobanana-mcp server with your Gemini API key.

Frequently Asked Questions about nano-banana

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate images with Gemini in Claude Code?

Install an MCP server such as nanobanana-mcp with your Gemini API key, then ask Claude to generate an image. The gemini_generate_image tool accepts prompt, model, aspectRatio, and imageSize parameters for creating images up to 4K resolution.

What is the difference between gemini-3.1-flash-image-preview and gemini-2.5-flash-image-preview?

gemini-3.1-flash-image-preview (Nano Banana 2) is the default model offering the highest quality, 4K output, and best text rendering at roughly $0.045 per 1K image. gemini-2.5-flash-image-preview is faster and cheaper but limited to 1K resolution, suiting prototyping and drafts.

How do I keep a character consistent across multiple AI images?

Define the character with highly specific physical details in the first generation, then reference it in later prompts using history:0 while describing only the new scene. Keep the artistic style and core features repeated in every subsequent prompt.

When should I use JSON prompting instead of natural language prompts?

Use JSON prompting when you need exact reproducibility, brand constraints, or scoped edits like changing only lighting without regenerating the scene. Natural language prompts are better for creative exploration, one-off images, and rapid ideation where speed matters more than precision.

Why is my nano-banana MCP server not connecting?

Verify your Gemini API key is valid at Google AI Studio and correctly set in the MCP server environment variables. Restart Claude Code after editing the configuration, and check the JSON syntax in your settings file for errors.

Can Gemini image models render accurate text inside images?

Yes, Nano Banana 2 renders text accurately for signs, posters, labels, and UI elements. Keep text under about ten words, put it in quotes, and specify a font style such as bold sans-serif or elegant serif for best results.