Nano Banana by Ace Data Cloud — Claude Code MCP server: how to install
Gives your agent image generation and editing with the Nano Banana model through the Ace Data Cloud API. Handy when a project needs pictures and you would rather stay in the chat.
claude mcp add --transport http mcp-nanobanana-pro https://nanobanana.mcp.acedata.cloud/mcpWhat Nano Banana by Ace Data Cloud does
The server exposes four tools. nanobanana_generate_image turns a text prompt into an image, and nanobanana_edit_image changes existing pictures or merges several into one. nanobanana_get_task and nanobanana_get_tasks_batch report the status and result of jobs, singly or in bulk. The listed use cases include putting clothes on people in photos and placing a product into a realistic scene.
There are three ways to connect. Point a client at the hosted URL https://nanobanana.mcp.acedata.cloud/mcp and sign in with OAuth in the browser, use the same URL with an API token in an Authorization: Bearer header, or run uvx mcp-nanobanana-pro locally with ACEDATACLOUD_API_TOKEN set. Don't combine OAuth with a fixed header on one server.
Every request goes through an Ace Data Cloud account and draws on its balance. No account means the browser sign-in fails, so check the price before the first real run. Results arrive asynchronously, and you need the original task ID to look them up.
What it helps with
- generate an image from a text description without leaving the agent chat
- merge several images into one with a prompt
- try clothing on a person from a photo
- place a product into a realistic scene
- check the status of several generation jobs at once
Example prompts for the agent
- Generate a flat-style coffee shop logo on a light background with Nano Banana
- Use
nanobanana_edit_imageto swap the background inhero.pngfor a sunset sky - Check the Nano Banana task with the task ID we saved earlier and tell me if the image is ready
How to install Nano Banana by Ace Data Cloud
1Platform CLI: remote server
claude mcp add --transport http mcp-nanobanana-pro https://nanobanana.mcp.acedata.cloud/mcp2Platform CLI
claude mcp add --env ACEDATACLOUD_API_TOKEN=<ACEDATACLOUD_API_TOKEN> --transport stdio nano-banana-by-ace-data-cloud -- uvx mcp-nanobanana-proReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-nanobanana-pro <command>
1Platform CLI: remote server
codex mcp add nano-banana-by-ace-data-cloud --url https://nanobanana.mcp.acedata.cloud/mcp2Platform CLI
codex mcp add nano-banana-by-ace-data-cloud --env ACEDATACLOUD_API_TOKEN=<ACEDATACLOUD_API_TOKEN> -- uvx mcp-nanobanana-proReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-nanobanana-pro <command>
Config file
{
"mcpServers": {
"nano-banana-by-ace-data-cloud": {
"url": "https://nanobanana.mcp.acedata.cloud/mcp"
}
}
}{
"mcpServers": {
"nano-banana-by-ace-data-cloud": {
"command": "uvx",
"args": [
"mcp-nanobanana-pro"
],
"env": {
"ACEDATACLOUD_API_TOKEN": "<ACEDATACLOUD_API_TOKEN>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-nanobanana-pro <command>
Config file
{
"servers": {
"nano-banana-by-ace-data-cloud": {
"type": "http",
"url": "https://nanobanana.mcp.acedata.cloud/mcp"
}
}
}{
"servers": {
"nano-banana-by-ace-data-cloud": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-nanobanana-pro"
],
"env": {
"ACEDATACLOUD_API_TOKEN": "<ACEDATACLOUD_API_TOKEN>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-nanobanana-pro <command>
1Platform CLI: remote server
gemini mcp add -t http nano-banana-by-ace-data-cloud https://nanobanana.mcp.acedata.cloud/mcp2Platform CLI
gemini mcp add -e ACEDATACLOUD_API_TOKEN=<ACEDATACLOUD_API_TOKEN> nano-banana-by-ace-data-cloud uvx mcp-nanobanana-proReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-nanobanana-pro <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Nano Banana by Ace Data Cloud
How do I install Nano Banana by Ace Data Cloud in Claude Code?
Run claude mcp add --transport http nano-banana-by-ace-data-cloud https://nanobanana.mcp.acedata.cloud/mcp, then sign in to your Ace Data Cloud account in the browser.
What does Nano Banana by Ace Data Cloud do?
It is an MCP server that lets an agent generate and edit images with the Nano Banana model and look up the status of those jobs. Requests go through the Ace Data Cloud API.
Do I need an API token?
Not for the hosted URL with OAuth: signing in to your Ace Data Cloud account is enough. Running uvx mcp-nanobanana-pro locally needs the ACEDATACLOUD_API_TOKEN variable.
