nano-banana-mcp

Nano Banana MCP Server 🍌

A Model Context Protocol (MCP) server that connects Claude to Nano Banana (Google's gemini-2.5-flash-image AI model), allowing Claude to seamlessly generate and edit images directly in your chat.

Features

• generate_image: Prompt Claude to generate high-resolution images. Features adjustable aspect ratios (1:1, 16:9, 9:16, 3:4, 4:3).

• Saves generated images automatically to your local machine and returns the exact file path to Claude.

Related MCP server: nb-mcp

Prerequisites

• Node.js (v18 or higher)

• A Google Gemini API Key (from Google AI Studio)

• Claude Desktop App

Setup & Installation

1. Clone the repository:

   git clone [https://github.com/yourusername/nano-banana-mcp.git](https://github.com/yourusername/nano-banana-mcp.git)
   cd nano-banana-mcp
   Install dependencies and build:

Bash npm install npm run build Configure Claude Desktop: Open your Claude Desktop configuration file:

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the MCP server to your config (replace /path/to/repo with the actual absolute path to this folder, and insert your API key):

JSON { "mcpServers": { "nano-banana": { "command": "node", "args": ["/path/to/repo/nano-banana-mcp/build/index.js"], "env": { "GEMINI_API_KEY": "your_actual_api_key_here" } } } } Restart Claude Desktop: Fully quit and restart the Claude Desktop application. You will now see the generate_image tool available (look for the hammer icon ⚒️ in your chat).

Usage Example Simply ask Claude:

"Hey Claude, use Nano Banana to generate a 16:9 image of a futuristic cyberpunk city covered in neon lights."

3. Finalizing for GitHub

1. Ensure you compile the code before pushing or running:

   npm run build
   Create a .gitignore file so you don't commit your build files or node modules:

Plaintext node_modules/ build/ .env Initialize Git, commit, and push:

Bash git init git add . git commit -m "Initial commit: Nano Banana MCP server" git branch -M main git remote add origin https://github.com/YOUR_USERNAME/nano-banana-mcp.git git push -u origin main