acedatacloud avatar

Nano Banana by Ace Data Cloud

acedatacloud/nanobananamcp

Connects Claude and other MCP clients to Google's Nano Banana image generation model through AceDataCloud's API. You get four tools: generate images from text prompts, edit or combine existing images, check task status, and batch query multiple tasks. Useful for AI-assisted image creation workflows where you want Claude to generate visuals inline during a conversation. AceDataCloud hosts a managed endpoint at nanobanana.mcp.acedata.cloud/mcp, so you can skip local setup and just add the URL with your API token. Also supports local installation via PyPI if you prefer stdio transport or need to self-host.

GitHub stars
9
tools
4
auth
Secret needed
transport
STDIO, HTTP
env var
1
last updated
Nov 12, 2026

Tools

4 tools

Public tool metadata for what this MCP can expose to an agent.

nanobanana_generate_imageGenerate an AI image from a text prompt using Google's Nano Banana model. This creates high-quality images from detailed text descriptions. The more descriptive your prompt, the better the results. Use this when: - You want to generate a new image from scratch - You have a det...5 params

Generate an AI image from a text prompt using Google's Nano Banana model. This creates high-quality images from detailed text descriptions. The more descriptive your prompt, the better the results. Use this when: - You want to generate a new image from scratch - You have a det...

Parameters* required
aspect_ratiostring
Aspect ratio of the generated image. Options: '1:1' (square, default), '3:2', '2:3', '16:9' (landscape), '9:16' (portrait), '4:3', '3:4'.one of 1:1 · 3:2 · 2:3 · 16:9 · 9:16 · 4:3default: 1:1
callback_urlstring
Optional webhook URL to receive the result asynchronously. The API will POST the result to this URL when complete.default:
modelstring
Model to use for generation. 'nano-banana' (default, alias of gemini-2.5-flash-image) is faster. 'nano-banana-2' is an improved version with better quality. 'nano-banana-pro' (alias of gemini-3-pro...one of nano-banana · nano-banana-2 · nano-banana-prodefault: nano-banana
promptstring
Description of the image to generate. Be descriptive about subject, atmosphere, lighting, camera/lens, and quality. Example: 'A photorealistic close-up portrait of an elderly Japanese ceramicist wi...
resolutionvalue
Resolution of the generated image. Options: '1K' (default), '2K', '4K'. Only works with 'nano-banana-pro' model.
nanobanana_edit_imageEdit or combine images using AI based on a text prompt. This allows you to modify existing images or combine multiple images together. Perfect for virtual try-on, product placement, image enhancement, and more. Use this when: - You want to combine multiple images (e.g., person...4 params

Edit or combine images using AI based on a text prompt. This allows you to modify existing images or combine multiple images together. Perfect for virtual try-on, product placement, image enhancement, and more. Use this when: - You want to combine multiple images (e.g., person...

Parameters* required
callback_urlstring
Optional webhook URL to receive the result asynchronously. The API will POST the result to this URL when complete.default:
image_urlsarray
List of image URLs to edit. Can be HTTP/HTTPS URLs (publicly accessible) or Base64-encoded images (data:image/png;base64,...). When combining multiple images, describe their relationship in the pro...
modelstring
Model to use for editing. 'nano-banana' (default, alias of gemini-2.5-flash-image) is faster. 'nano-banana-2' is an improved version with better quality. 'nano-banana-pro' (alias of gemini-3-pro-im...one of nano-banana · nano-banana-2 · nano-banana-prodefault: nano-banana
promptstring
Description of the edit to perform. Describe how the images should be combined or modified. Example: 'let this person wear this T-shirt', 'place this product in a modern kitchen scene'
nanobanana_get_taskQuery the status and result of an image generation or edit task. Use this to check if a generation/edit is complete and retrieve the resulting image URLs and metadata. Use this when: - You want to check if an image generation has completed - You need to retrieve image URLs fro...1 params

Query the status and result of an image generation or edit task. Use this to check if a generation/edit is complete and retrieve the resulting image URLs and metadata. Use this when: - You want to check if an image generation has completed - You need to retrieve image URLs fro...

Parameters* required
task_idstring
The task ID returned from a generation or edit request. This is the 'task_id' field from any nanobanana_generate_image or nanobanana_edit_image tool response.
nanobanana_get_tasks_batchQuery multiple image generation/edit tasks at once. Efficiently check the status of multiple tasks in a single request. More efficient than calling nanobanana_get_task multiple times. Use this when: - You have multiple pending generations to check - You want to get status of s...1 params

Query multiple image generation/edit tasks at once. Efficiently check the status of multiple tasks in a single request. More efficient than calling nanobanana_get_task multiple times. Use this when: - You have multiple pending generations to check - You want to get status of s...

Parameters* required
task_idsarray
List of task IDs to query. Allows querying multiple tasks at once.

Sponsors

Configuration

ACEDATACLOUD_API_TOKEN*secret

API token from Ace Data Cloud (https://platform.acedata.cloud)

Readme

Nano Banana by Ace Data Cloud

简体中文安装与首用指南

PyPI version PyPI downloads Python 3.10+ License: MIT MCP

A Model Context Protocol (MCP) server for AI image generation and editing using Google's Nano Banana model through the AceDataCloud API.

Generate and edit AI images directly from Claude, VS Code, or any MCP-compatible client.


View the full README on GitHub

Details

Repository
github.com/acedatacloud/nanobananamcp
Website
platform.acedata.cloud/documents/nano-banana-mcp?utm_source=mcp_registry&utm_medium=referral&utm_campaign=evergreen&utm_content=nanobanana_mcp_listing_guide
Categories
Data & Analytics, Productivity & Office
Package
mcp-nanobanana-pro
Transport
STDIO, HTTP
Auth
Required
Registry
MCP registry, active

More from acedatacloud

Related Data & Analytics MCP servers

View all
1paulieb89 avatarUK Property Datapaulieb89/property-sharedUK property data — Land Registry comps, EPC, Rightmove, rental yields, stamp duty, Companies House9stars
2virtualflybrain avatarVirtualFlyBrainvirtualflybrain/vfb3-mcpMCP server for Drosophila neuroscience data from VirtualFlyBrain9stars
3wei avatarMymlh Mcp Serverwei/mymlh-mcp-serverOAuth-enabled MyMLH MCP server for accessing MyMLH data.9stars
4la-rebelion avatarLinkedIn MCP Serverla-rebelion/hapimcpLinkedIn API as MCP tools to retrieve profile data and publish content. Powered by HAPI MCP.0stars
5amirdaraee avatarLuxembourg MCPamirdaraee/luxembourg-mcpKeyless MCP access to official Luxembourg public data: laws, statistics, mobility, and more.8stars
6cryptoquantofficial avatarCryptoQuantcryptoquantofficial/cryptoquant-mcpQuery cryptocurrency on-chain data, OHLCV prices, market data, and Research & QuickTake insights.8stars