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

# Guia de Integração do Nano Banana MCP

> nanobanana MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) é 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 XHuoAPI, 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 XHuoAPI:

1. Registre-se ou faça login na [plataforma XHuoAPI](https://api.xhuoapi.ai)
2. Vá para a página da [API de Imagens Nano Banana](https://api.xhuoapi.ai/documents/nano-banana-images)
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)

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

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

```bash theme={null}
git clone https://github.com/XHuoAPI/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:

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

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

```json theme={null}
{
  "mcpServers": {
    "nanobanana": {
      "command": "uvx",
      "args": ["mcp-nanobanana-pro"],
      "env": {
        "XHuoAPI_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:

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

Ou use `uvx`:

```json theme={null}
{
  "servers": {
    "nanobanana": {
      "command": "uvx",
      "args": ["mcp-nanobanana-pro"],
      "env": {
        "XHuoAPI_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: [XHuoAPI/NanoBananaMCP](https://github.com/XHuoAPI/NanoBananaMCP)
* Pacote PyPI: [mcp-nanobanana-pro](https://pypi.org/project/mcp-nanobanana-pro/)
* Documentação da API: [Nano Banana API](https://api.xhuoapi.ai/documents/nano-banana)