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

# Guía de Integración de Nano Banana MCP

> nanobanana MCP 服务器集成

[MCP (Modelo Contexto Protocolo)](https://modelcontextprotocol.io) es un protocolo de contexto de modelo lanzado por Anthropic, que permite a los modelos de IA (como Claude, GPT, etc.) llamar a herramientas externas a través de interfaces estandarizadas. A través del Nano Banana MCP Server proporcionado por XHuoAPI, puedes generar y editar imágenes de IA directamente en clientes de IA como Claude Desktop, VS Code, Cursor, etc.

## Resumen de Funciones

Nano Banana MCP Server ofrece las siguientes funciones clave:

* **Generación de imágenes** — Generar imágenes de alta calidad a través de indicaciones de texto
* **Edición de imágenes** — Modificar imágenes existentes o combinar varias imágenes
* **Prueba virtual de ropa** — Colocar ropa en fotos de personas
* **Inserción de productos** — Colocar productos en escenas reales
* **Soporte para múltiples modelos** — Soporta los modelos nano-banana, nano-banana-2 y nano-banana-pro
* **Consulta de tareas** — Monitorear el progreso de generación y obtener resultados

## Preparativos Previos

Antes de usar, necesitas obtener el Token de API de XHuoAPI:

1. Regístrate o inicia sesión en [la plataforma XHuoAPI](https://api.xhuoapi.ai)
2. Ve a la página de [API de Imágenes de Nano Banana](https://api.xhuoapi.ai/documents/nano-banana-images)
3. Haz clic en "Acquire" para obtener el Token de API (la primera solicitud incluye un crédito gratuito)

## Instalación y Configuración

### Método 1: Instalación con pip (recomendado)

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

### Método 2: Instalación desde el código fuente

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

Una vez completada la instalación, puedes usar el comando `mcp-nanobanana-pro` para iniciar el servicio.

## Uso en Claude Desktop

Edita el archivo de configuración de Claude Desktop:

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

Agrega la siguiente configuración:

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

Si usas `uvx` (sin necesidad de instalar paquetes previamente):

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

Guarda la configuración y reinicia Claude Desktop para poder usar las herramientas relacionadas con Nano Banana en la conversación.

## Uso en VS Code / Cursor

Crea un archivo `.vscode/mcp.json` en el directorio raíz del proyecto:

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

O usa `uvx`:

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

## Lista de Herramientas Disponibles

| Nombre de la herramienta     | Descripción                                        |
| ---------------------------- | -------------------------------------------------- |
| `nanobanana_generate_image`  | Generar imágenes a partir de indicaciones de texto |
| `nanobanana_edit_image`      | Editar o combinar imágenes existentes              |
| `nanobanana_get_task`        | Consultar el estado de una tarea individual        |
| `nanobanana_get_tasks_batch` | Consultar el estado de tareas en lote              |

## Ejemplos de Uso

Una vez configurado, puedes llamar a estas funciones directamente en el cliente de IA usando lenguaje natural, por ejemplo:

* "Ayúdame a generar una pintura de paisajes en estilo acuarela"
* "Coloca esta ropa en esta persona"
* "Pon este producto en una escena de cafetería"
* "Genera un retrato de alta calidad con el modelo nano-banana-pro"

## Más Información

* Repositorio de GitHub: [XHuoAPI/NanoBananaMCP](https://github.com/XHuoAPI/NanoBananaMCP)
* Paquete de PyPI: [mcp-nanobanana-pro](https://pypi.org/project/mcp-nanobanana-pro/)
* Documentación de la API: [API de Nano Banana](https://api.xhuoapi.ai/documents/nano-banana)