MCP Server Nano Banana README

The full upstream README, mirrored for reference. Install config, tool schemas, adoption signals and our own overview live on the MCP Server Nano Banana listing page.

@nanana-ai/mcp-server-nano-banana

MCP (Model Context Protocol) server for Nanana AI image generation service powered by Google Gemini's nano banana model. This server allows Claude Desktop and other MCP clients to generate and transform images using nano banana's powerful image generation capabilities.

Installation

Terminal
npm install -g @nanana-ai/mcp-server-nano-banana

Configuration

1. Get your API token

  1. Visit nanana.app and sign in
  2. Go to your account dashboard
  3. Generate an API token in the "API Access" section
  4. Copy and save the token (it will only be shown once)

2. Configure Claude Desktop

Add the server to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

config.json
{
  "mcpServers": {
    "nanana": {
      "command": "npx",
      "args": ["-y", "@nanana-ai/mcp-server-nano-banana"],
      "env": {
        "NANANA_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

3. Restart Claude Desktop

After saving the config file, restart Claude Desktop to load the MCP server.

Available Tools

text_to_image

Generate an image from a text prompt.

Parameters:

  • prompt (string, required): The text description of the image to generate

Example:

Code
Generate an image of a cute cat wearing a hat

image_to_image

Transform existing images based on a text prompt.

Parameters:

  • imageUrls (array of strings, required): 1-9 image URLs to transform
  • prompt (string, required): The text description of how to transform the images

Example:

Code
Transform these images to look like oil paintings: ["https://example.com/image1.jpg"]

Environment Variables

  • NANANA_API_TOKEN (required): Your Nanana AI API token
  • NANANA_API_URL (optional): Custom API URL (defaults to https://nanana.app)

Development

Local Testing

  1. Clone the repository
  2. Install dependencies: npm install
  3. Build: npm run build
  4. Test locally by updating Claude Desktop config to point to the built file:
config.json
{
  "mcpServers": {
    "nanana": {
      "command": "node",
      "args": ["/path/to/packages/mcp-server/dist/index.js"],
      "env": {
        "NANANA_API_TOKEN": "your-token",
        "NANANA_API_URL": "http://localhost:3000"
      }
    }
  }
}

Build

Terminal
npm run build

Watch mode

Terminal
npm run dev

Credits and Pricing

Image generation with nano banana consumes credits from your Nanana AI account. Check your dashboard at nanana.app/account to view your credit balance and purchase more credits if needed.

Support

For issues and questions:

License

MIT