Guia de Integração do Nano Banana MCP

MCP (Model Context Protocol) é um protocolo de contexto de modelo lançado pela Anthropic, que permite que modelos de IA (como Claude, GPT, etc.) chamem ferramentas externas através de interfaces padronizadas. Com o Nano Banana MCP Server fornecido pela AceData Cloud, você pode gerar e editar imagens de IA diretamente em clientes de IA como Claude Desktop, VS Code, Cursor, entre outros.

Visão Geral das Funcionalidades

O Nano Banana MCP Server oferece as seguintes funcionalidades principais:

Geração de Imagens — Geração de imagens de alta qualidade a partir de prompts de texto
Edição de Imagens — Modificação de imagens existentes ou combinação de várias imagens
Prova Virtual de Roupas — Colocar roupas em fotos de pessoas
Inserção de Produtos — Colocar produtos em cenários reais
Suporte a Múltiplos Modelos — Suporte aos modelos nano-banana, nano-banana-2 e nano-banana-pro
Consulta de Tarefas — Monitoramento do progresso de geração e obtenção de resultados

Preparativos

Antes de usar, você precisa obter o Token da API da AceData Cloud:

Registre-se ou faça login na plataforma AceData Cloud
Vá para a página da API de Imagens Nano Banana
Clique em “Acquire” para obter o Token da API (primeira solicitação oferece crédito gratuito)

Instalação e Configuração

Método 1: Instalação via pip (recomendado)

pip install mcp-nanobanana-pro

Método 2: Instalação a partir do código-fonte

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

Após a instalação, você pode usar o comando mcp-nanobanana-pro para iniciar o serviço.

Usando no Claude Desktop

Edite o arquivo de configuração do Claude Desktop:

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

Adicione a seguinte configuração:

{
  "mcpServers": {
    "nanobanana": {
      "command": "mcp-nanobanana-pro",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "seu Token da API"
      }
    }
  }
}

Se usar uvx (sem necessidade de instalar pacotes previamente):

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

Após salvar a configuração, reinicie o Claude Desktop para usar as ferramentas relacionadas ao Nano Banana nas conversas.

Usando no VS Code / Cursor

Crie um arquivo .vscode/mcp.json no diretório raiz do projeto:

{
  "servers": {
    "nanobanana": {
      "command": "mcp-nanobanana-pro",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "seu Token da API"
      }
    }
  }
}

Ou use uvx:

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

Lista de Ferramentas Disponíveis

Nome da Ferramenta	Descrição
`nanobanana_generate_image`	Geração de imagens a partir de prompts de texto
`nanobanana_edit_image`	Edição ou combinação de imagens existentes
`nanobanana_get_task`	Consulta de status de uma única tarefa
`nanobanana_get_tasks_batch`	Consulta em lote de status de tarefas

Exemplos de Uso

Após a configuração, você pode chamar essas funcionalidades diretamente em linguagem natural nos clientes de IA, por exemplo:

“Ajude-me a gerar uma pintura de paisagem em estilo aquarela”
“Coloque esta roupa na foto desta pessoa”
“Coloque este produto em um cenário de cafeteria”
“Gere um retrato de alta qualidade usando o modelo nano-banana-pro”

Mais Informações

Repositório no GitHub: AceDataCloud/NanoBananaMCP
Pacote PyPI: mcp-nanobanana-pro
Documentação da API: Nano Banana API

​Visão Geral das Funcionalidades

​Preparativos

​Instalação e Configuração

​Método 1: Instalação via pip (recomendado)

​Método 2: Instalação a partir do código-fonte

​Usando no Claude Desktop

​Usando no VS Code / Cursor

​Lista de Ferramentas Disponíveis

​Exemplos de Uso

​Mais Informações