> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Guida all'integrazione di Nano Banana MCP

> nanobanana MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) è 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 XHuoAPI, 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 XHuoAPI:

1. Registrati o accedi alla [piattaforma XHuoAPI](https://api.xhuoapi.ai)
2. Vai alla pagina [Nano Banana Images API](https://api.xhuoapi.ai/documents/nano-banana-images)
3. Clicca su "Acquire" per ottenere il Token API (il primo acquisto include un credito gratuito)

## Installazione e configurazione

### Metodo 1: installazione con pip (consigliato)

```bash theme={null}
pip install mcp-nanobanana-pro
```

### Metodo 2: installazione da sorgente

```bash theme={null}
git clone https://github.com/XHuoAPI/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:

```json theme={null}
{
  "mcpServers": {
    "nanobanana": {
      "command": "mcp-nanobanana-pro",
      "env": {
        "XHuoAPI_API_TOKEN": "il tuo Token API"
      }
    }
  }
}
```

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

```json theme={null}
{
  "mcpServers": {
    "nanobanana": {
      "command": "uvx",
      "args": ["mcp-nanobanana-pro"],
      "env": {
        "XHuoAPI_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:

```json theme={null}
{
  "servers": {
    "nanobanana": {
      "command": "mcp-nanobanana-pro",
      "env": {
        "XHuoAPI_API_TOKEN": "il tuo Token API"
      }
    }
  }
}
```

Oppure utilizza `uvx`:

```json theme={null}
{
  "servers": {
    "nanobanana": {
      "command": "uvx",
      "args": ["mcp-nanobanana-pro"],
      "env": {
        "XHuoAPI_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: [XHuoAPI/NanoBananaMCP](https://github.com/XHuoAPI/NanoBananaMCP)
* Pacchetto PyPI: [mcp-nanobanana-pro](https://pypi.org/project/mcp-nanobanana-pro/)
* Documentazione API: [Nano Banana API](https://api.xhuoapi.ai/documents/nano-banana)