Saltar para o conteúdo principal
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:
  1. Registre-se ou faça login na plataforma AceData Cloud
  2. Vá para a página da API de Imagens Nano Banana
  3. 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/MCPNanoBanana.git
cd MCPNanoBanana
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 FerramentaDescrição
nanobanana_generate_imageGeração de imagens a partir de prompts de texto
nanobanana_edit_imageEdição ou combinação de imagens existentes
nanobanana_get_taskConsulta de status de uma única tarefa
nanobanana_get_tasks_batchConsulta 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