Guía de Integración de Nano Banana MCP

MCP (Modelo Contexto Protocolo) 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 AceData Cloud, 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 AceData Cloud:

Regístrate o inicia sesión en la plataforma AceData Cloud
Ve a la página de API de Imágenes de Nano Banana
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)

pip install mcp-nanobanana-pro

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

git clone https://github.com/AceDataCloud/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:

{
  "mcpServers": {
    "nanobanana": {
      "command": "mcp-nanobanana-pro",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "tu Token de API"
      }
    }
  }
}

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

{
  "mcpServers": {
    "nanobanana": {
      "command": "uvx",
      "args": ["mcp-nanobanana-pro"],
      "env": {
        "ACEDATACLOUD_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:

{
  "servers": {
    "nanobanana": {
      "command": "mcp-nanobanana-pro",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "tu Token de API"
      }
    }
  }
}

O usa uvx:

{
  "servers": {
    "nanobanana": {
      "command": "uvx",
      "args": ["mcp-nanobanana-pro"],
      "env": {
        "ACEDATACLOUD_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: AceDataCloud/NanoBananaMCP
Paquete de PyPI: mcp-nanobanana-pro
Documentación de la API: API de Nano Banana

​Resumen de Funciones

​Preparativos Previos

​Instalación y Configuración

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

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

​Uso en Claude Desktop

​Uso en VS Code / Cursor

​Lista de Herramientas Disponibles

​Ejemplos de Uso

​Más Información