> ## 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.

# Nano Banana MCP Guide de Connexion

> nanobanana MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) est un protocole de contexte de modèle lancé par Anthropic, permettant aux modèles d'IA (comme Claude, GPT, etc.) d'appeler des outils externes via une interface standardisée. Grâce au Nano Banana MCP Server fourni par XHuoAPI, vous pouvez générer et éditer directement des images AI dans des clients AI tels que Claude Desktop, VS Code, Cursor, etc.

## Vue d'ensemble des fonctionnalités

Le Nano Banana MCP Server offre les fonctionnalités principales suivantes :

* **Génération d'images** — Générer des images de haute qualité à partir de mots-clés textuels
* **Édition d'images** — Modifier des images existantes ou combiner plusieurs images
* **Essayage virtuel** — Mettre des vêtements sur des photos de personnes
* **Placement de produits** — Placer des produits dans des scènes réelles
* **Support multi-modèles** — Prise en charge des modèles nano-banana, nano-banana-2 et nano-banana-pro
* **Consultation de tâches** — Surveiller l'avancement de la génération et obtenir des résultats

## Préparations Préalables

Avant utilisation, vous devez obtenir un token API XHuoAPI :

1. Inscrivez-vous ou connectez-vous à la [plateforme XHuoAPI](https://api.xhuoapi.ai)
2. Rendez-vous sur la page [Nano Banana Images API](https://api.xhuoapi.ai/documents/nano-banana-images)
3. Cliquez sur « Acquire » pour obtenir un token API (un quota gratuit est offert lors de la première demande)

## Installation et Configuration

### Méthode 1 : Installation via pip (recommandée)

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

### Méthode 2 : Installation à partir du code source

```bash theme={null}
git clone https://github.com/XHuoAPI/NanoBananaMCP.git
cd NanoBananaMCP
pip install -e .
```

Une fois l'installation terminée, vous pouvez utiliser la commande `mcp-nanobanana-pro` pour démarrer le service.

## Utilisation dans Claude Desktop

Éditez le fichier de configuration de Claude Desktop :

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

Ajoutez la configuration suivante :

```json theme={null}
{
  "mcpServers": {
    "nanobanana": {
      "command": "mcp-nanobanana-pro",
      "env": {
        "XHuoAPI_API_TOKEN": "votre token API"
      }
    }
  }
}
```

Si vous utilisez `uvx` (pas besoin d'installer le package à l'avance) :

```json theme={null}
{
  "mcpServers": {
    "nanobanana": {
      "command": "uvx",
      "args": ["mcp-nanobanana-pro"],
      "env": {
        "XHuoAPI_API_TOKEN": "votre token API"
      }
    }
  }
}
```

Après avoir enregistré la configuration, redémarrez Claude Desktop pour pouvoir utiliser les outils liés à Nano Banana dans la conversation.

## Utilisation dans VS Code / Cursor

Créez un fichier `.vscode/mcp.json` dans le répertoire racine du projet :

```json theme={null}
{
  "servers": {
    "nanobanana": {
      "command": "mcp-nanobanana-pro",
      "env": {
        "XHuoAPI_API_TOKEN": "votre token API"
      }
    }
  }
}
```

Ou utilisez `uvx` :

```json theme={null}
{
  "servers": {
    "nanobanana": {
      "command": "uvx",
      "args": ["mcp-nanobanana-pro"],
      "env": {
        "XHuoAPI_API_TOKEN": "votre token API"
      }
    }
  }
}
```

## Liste des Outils Disponibles

| Nom de l'outil               | Description                                       |
| ---------------------------- | ------------------------------------------------- |
| `nanobanana_generate_image`  | Générer des images à partir de mots-clés textuels |
| `nanobanana_edit_image`      | Éditer ou combiner des images existantes          |
| `nanobanana_get_task`        | Consulter l'état d'une tâche unique               |
| `nanobanana_get_tasks_batch` | Consulter l'état des tâches par lot               |

## Exemples d'Utilisation

Une fois la configuration terminée, vous pouvez appeler ces fonctionnalités directement en langage naturel dans le client AI, par exemple :

* « Aide-moi à générer une peinture de paysage à l'aquarelle »
* « Mets ce vêtement sur cette personne en PS »
* « Place ce produit dans une scène de café »
* « Génère un portrait de haute qualité avec le modèle nano-banana-pro »

## Plus d'Informations

* Dépôt GitHub : [XHuoAPI/NanoBananaMCP](https://github.com/XHuoAPI/NanoBananaMCP)
* Package PyPI : [mcp-nanobanana-pro](https://pypi.org/project/mcp-nanobanana-pro/)
* Documentation API : [Nano Banana API](https://api.xhuoapi.ai/documents/nano-banana)