Provides AI image generation and editing capabilities using Google's Gemini 2.5 Flash Image API, allowing users to create new images from text descriptions, edit existing images with prompts, and perform iterative image modifications
Nano-Banana MCP Server 🍌
🤖 This project was entirely generated by Claude Code - an AI coding assistant that can create complete, production-ready applications from scratch.
A Model Context Protocol (MCP) server that provides AI image generation and editing capabilities using Google's Gemini 2.5 Flash Image API. Generate stunning images, edit existing ones, and iterate on your creations with simple text prompts.
✨ Features
- 🎨 Generate Images: Create new images from text descriptions
- ✏️ Edit Images: Modify existing images with text prompts
- 🔄 Iterative Editing: Continue editing the last generated/edited image
- 🖼️ Multiple Reference Images: Use reference images for style transfer and guidance
- 🌍 Cross-Platform: Smart file paths for Windows, macOS, and Linux
- 🔧 Easy Setup: Simple configuration with API key
- 📁 Auto File Management: Automatic image saving with organized naming
🔑 Setup
- Get your Gemini API key:
- Visit Google AI Studio
- Create a new API key
- Copy it for configuration
- Configure the MCP server: See configuration examples for your specific client below (Claude Code, Cursor, or other MCP clients).
💻 Usage with Claude Code
Configuration:
Add this to your Claude Code MCP settings:
Option A: With environment variable (Recommended - Most Secure)
Option B: Without environment variable
Usage Examples:
🎯 Usage with Cursor
Configuration:
Add to your Cursor MCP configuration:
Option A: With environment variable (Recommended)
Option B: Without environment variable
Usage Examples:
- Ask Cursor to generate images for your app
- Create mockups and prototypes
- Generate assets for your projects
🔧 For Other MCP Clients
If you're using a different MCP client, you can configure nano-banana-mcp using any of these methods:
Configuration Methods
Method A: Environment Variable in MCP Config (Recommended)
Method B: System Environment Variable
Method C: Using the Configure Tool
🛠️ Available Commands
generate_image
Create a new image from a text prompt.
edit_image
Edit a specific image file.
continue_editing
Continue editing the last generated/edited image.
get_last_image_info
Get information about the last generated image.
configure_gemini_token
Configure your Gemini API key.
get_configuration_status
Check if the API key is configured.
⚙️ Configuration Priority
The MCP server loads your API key in the following priority order:
- 🥇 MCP Configuration Environment Variables (Highest Priority)
- Set in your
claude_desktop_config.json
or MCP client config - Most secure as it's contained within the MCP configuration
- Example:
"env": { "GEMINI_API_KEY": "your-key" }
- Set in your
- 🥈 System Environment Variables
- Set in your shell/system environment
- Example:
export GEMINI_API_KEY="your-key"
- 🥉 Local Configuration File (Lowest Priority)
- Created when using the
configure_gemini_token
tool - Stored as
.nano-banana-config.json
in current directory - Automatically ignored by Git and NPM
- Created when using the
💡 Recommendation: Use Method 1 (MCP config env variables) for the best security and convenience.
📁 File Storage
Images are automatically saved to platform-appropriate locations:
- Windows:
%USERPROFILE%\\Documents\\nano-banana-images\\
- macOS/Linux:
./generated_imgs/
(in current directory) - System directories:
~/nano-banana-images/
(when run from system paths)
File naming convention:
- Generated images:
generated-[timestamp]-[id].png
- Edited images:
edited-[timestamp]-[id].png
🎨 Example Workflows
Basic Image Generation
generate_image
- Create your base imagecontinue_editing
- Refine and improvecontinue_editing
- Add final touches
Style Transfer
generate_image
- Create base contentedit_image
- Use reference images for stylecontinue_editing
- Fine-tune the result
Iterative Design
generate_image
- Start with a conceptget_last_image_info
- Check current statecontinue_editing
- Make adjustments- Repeat until satisfied
🔧 Development
This project was created with Claude Code and follows these technologies:
- TypeScript - Type-safe development
- Node.js - Runtime environment
- Zod - Schema validation
- Google GenAI - Image generation API
- MCP SDK - Model Context Protocol
Local Development
📋 Requirements
- Node.js 18.0.0 or higher
- Gemini API key from Google AI Studio
- Compatible with Claude Code, Cursor, and other MCP clients
🤝 Contributing
This project was generated by Claude Code, but contributions are welcome! Please feel free to:
- Report bugs
- Suggest new features
- Submit pull requests
- Improve documentation
📄 License
MIT License - see LICENSE file for details.
🙏 Acknowledgments
- Claude Code - For generating this entire project
- Google AI - For the powerful Gemini 2.5 Flash Image API
- Anthropic - For the Model Context Protocol
- Open Source Community - For the amazing tools and libraries
📞 Support
- 🐛 Issues: GitHub Issues
- 📖 Documentation: This README and inline code comments
- 💬 Discussions: GitHub Discussions
✨ Generated with love by Claude Code - The future of AI-powered development is here!
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
A Nano Banana MCP server, which you can integrate to cursor/claude code and any mcp client