mcp-server-nano-banana

Geração de imagens por IA com o modelo Nano-Banana do Google Gemini.

Documentação

@nanana-ai/mcp-server-nano-banana

Servidor MCP (Model Context Protocol) para o serviço de geração de imagens Nanana AI, alimentado pelo modelo nano banana do Google Gemini. Este servidor permite que o Claude Desktop e outros clientes MCP gerem e transformem imagens usando as poderosas capacidades de geração de imagens do nano banana.

Instalação

npm install -g @nanana-ai/mcp-server-nano-banana

Configuração

1. Obtenha seu token de API

  1. Visite nanana.app e faça login
  2. Acesse o painel da sua conta
  3. Gere um token de API na seção "API Access"
  4. Copie e salve o token (ele será exibido apenas uma vez)

2. Configure o Claude Desktop

Adicione o servidor ao arquivo de configuração do Claude Desktop:

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

{
  "mcpServers": {
    "nanana": {
      "command": "npx",
      "args": ["-y", "@nanana-ai/mcp-server-nano-banana"],
      "env": {
        "NANANA_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

3. Reinicie o Claude Desktop

Após salvar o arquivo de configuração, reinicie o Claude Desktop para carregar o servidor MCP.

Ferramentas Disponíveis

text_to_image

Gere uma imagem a partir de um prompt de texto.

Parâmetros:

  • prompt (string, obrigatório): A descrição em texto da imagem a ser gerada

Exemplo:

Generate an image of a cute cat wearing a hat

image_to_image

Transforme imagens existentes com base em um prompt de texto.

Parâmetros:

  • imageUrls (array de strings, obrigatório): 1-9 URLs de imagens para transformar
  • prompt (string, obrigatório): A descrição em texto de como transformar as imagens

Exemplo:

Transform these images to look like oil paintings: ["https://example.com/image1.jpg"]

Variáveis de Ambiente

  • NANANA_API_TOKEN (obrigatório): Seu token de API da Nanana AI
  • NANANA_API_URL (opcional): URL de API personalizada (padrão: https://nanana.app)

Desenvolvimento

Teste Local

  1. Clone o repositório
  2. Instale as dependências: npm install
  3. Compile: npm run build
  4. Teste localmente atualizando a configuração do Claude Desktop para apontar para o arquivo compilado:
{
  "mcpServers": {
    "nanana": {
      "command": "node",
      "args": ["/path/to/packages/mcp-server/dist/index.js"],
      "env": {
        "NANANA_API_TOKEN": "your-token",
        "NANANA_API_URL": "http://localhost:3000"
      }
    }
  }
}

Compilação

npm run build

Modo de observação

npm run dev

Créditos e Preços

A geração de imagens com nano banana consome créditos da sua conta Nanana AI. Verifique seu painel em nanana.app/account para visualizar seu saldo de créditos e comprar mais créditos, se necessário.

Suporte

Para problemas e dúvidas:

Licença

MIT