Guida all'integrazione di Nano Banana MCP

MCP (Model Context Protocol) è un protocollo di contesto del modello lanciato da Anthropic, che consente ai modelli AI (come Claude, GPT, ecc.) di chiamare strumenti esterni tramite interfacce standardizzate. Attraverso il Nano Banana MCP Server fornito da AceData Cloud, puoi generare e modificare immagini AI direttamente nei client AI come Claude Desktop, VS Code, Cursor, ecc.

Panoramica delle funzionalità

Il Nano Banana MCP Server offre le seguenti funzionalità principali:

Generazione di immagini — Genera immagini di alta qualità tramite suggerimenti testuali
Modifica di immagini — Modifica immagini esistenti o combina più immagini
Prova virtuale — Indossa abbigliamento su foto di persone
Product placement — Inserisci prodotti in scenari reali
Supporto multi-modello — Supporta i modelli nano-banana, nano-banana-2 e nano-banana-pro
Query di attività — Monitora il progresso della generazione e ottieni risultati

Preparazione preliminare

Prima di utilizzare, è necessario ottenere il Token API di AceData Cloud:

Registrati o accedi alla piattaforma AceData Cloud
Vai alla pagina Nano Banana Images API
Clicca su “Acquire” per ottenere il Token API (il primo acquisto include un credito gratuito)

Installazione e configurazione

Metodo 1: installazione con pip (consigliato)

pip install mcp-nanobanana-pro

Metodo 2: installazione da sorgente

git clone https://github.com/AceDataCloud/NanoBananaMCP.git
cd NanoBananaMCP
pip install -e .

Dopo aver completato l’installazione, puoi avviare il servizio utilizzando il comando mcp-nanobanana-pro.

Utilizzo in Claude Desktop

Modifica il file di configurazione di Claude Desktop:

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

Aggiungi la seguente configurazione:

{
  "mcpServers": {
    "nanobanana": {
      "command": "mcp-nanobanana-pro",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "il tuo Token API"
      }
    }
  }
}

Se utilizzi uvx (non è necessario installare pacchetti in anticipo):

{
  "mcpServers": {
    "nanobanana": {
      "command": "uvx",
      "args": ["mcp-nanobanana-pro"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "il tuo Token API"
      }
    }
  }
}

Dopo aver salvato la configurazione, riavvia Claude Desktop per utilizzare gli strumenti relativi a Nano Banana nella conversazione.

Utilizzo in VS Code / Cursor

Crea un file .vscode/mcp.json nella directory principale del progetto:

{
  "servers": {
    "nanobanana": {
      "command": "mcp-nanobanana-pro",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "il tuo Token API"
      }
    }
  }
}

Oppure utilizza uvx:

{
  "servers": {
    "nanobanana": {
      "command": "uvx",
      "args": ["mcp-nanobanana-pro"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "il tuo Token API"
      }
    }
  }
}

Elenco degli strumenti disponibili

Nome dello strumento	Descrizione
`nanobanana_generate_image`	Genera immagini tramite suggerimenti testuali
`nanobanana_edit_image`	Modifica o combina immagini esistenti
`nanobanana_get_task`	Consulta lo stato di un singolo compito
`nanobanana_get_tasks_batch`	Consulta lo stato di più compiti in batch

Esempi di utilizzo

Dopo aver completato la configurazione, puoi chiamare queste funzionalità direttamente nel client AI utilizzando un linguaggio naturale, ad esempio:

“Aiutami a generare un dipinto paesaggistico in stile acquerello”
“Applica questo vestito a questa persona”
“Posiziona questo prodotto in un contesto di caffetteria”
“Genera un ritratto di alta qualità utilizzando il modello nano-banana-pro”

Maggiori informazioni

Repository GitHub: AceDataCloud/NanoBananaMCP
Pacchetto PyPI: mcp-nanobanana-pro
Documentazione API: Nano Banana API

​Panoramica delle funzionalità

​Preparazione preliminare

​Installazione e configurazione

​Metodo 1: installazione con pip (consigliato)

​Metodo 2: installazione da sorgente

​Utilizzo in Claude Desktop

​Utilizzo in VS Code / Cursor

​Elenco degli strumenti disponibili

​Esempi di utilizzo

​Maggiori informazioni