# Nano Banana by Ace Data Cloud

Подключает к агенту генерацию и правку изображений моделью Nano Banana через API Ace Data Cloud. Пригодится, когда картинки нужны, а открывать отдельный сервис не хочется.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7
- Автор: AceDataCloud
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/AceDataCloud/NanoBananaMCP
- Обновлён: 2026-10-19
- HTML: https://affpapa.org/nevibecode/mcp/nano-banana-by-ace-data-cloud

## Что делает

Сервер даёт агенту четыре инструмента. `nanobanana_generate_image` рисует картинку по текстовому промпту, `nanobanana_edit_image` правит готовые изображения или объединяет несколько в одно. `nanobanana_get_task` и `nanobanana_get_tasks_batch` возвращают статус и результат задач, по одной или сразу пачкой. Среди сценариев в описании: примерка одежды на людях с фото и размещение товара в реалистичной сцене.

Подключиться можно тремя путями: удалённый адрес `https://nanobanana.mcp.acedata.cloud/mcp` с входом через OAuth в браузере, тот же адрес с API-токеном в заголовке `Authorization: Bearer`, либо локальный процесс `uvx mcp-nanobanana-pro` с переменной `ACEDATACLOUD_API_TOKEN`. OAuth и фиксированный заголовок для одного сервера не совмещайте.

Генерация идёт через аккаунт Ace Data Cloud и тратит его баланс. Без аккаунта вход в браузере не пройдёт, поэтому цену лучше посмотреть до первого запуска. Результат приходит асинхронно, и для проверки нужен исходный task ID.

## Требования
- Нужно: Python и uv (команды через uvx)
- Удалённый сервер: `https://nanobanana.mcp.acedata.cloud/mcp`
- Переменные окружения: `ACEDATACLOUD_API_TOKEN` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http mcp-nanobanana-pro https://nanobanana.mcp.acedata.cloud/mcp
```

2. **Командой платформы**
```bash
claude mcp add --env ACEDATACLOUD_API_TOKEN=<ACEDATACLOUD_API_TOKEN> --transport stdio nano-banana-by-ace-data-cloud -- uvx mcp-nanobanana-pro
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-nanobanana-pro <команда>

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add nano-banana-by-ace-data-cloud --url https://nanobanana.mcp.acedata.cloud/mcp
```

2. **Командой платформы**
```bash
codex mcp add nano-banana-by-ace-data-cloud --env ACEDATACLOUD_API_TOKEN=<ACEDATACLOUD_API_TOKEN> -- uvx mcp-nanobanana-pro
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-nanobanana-pro <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "nano-banana-by-ace-data-cloud": {
            "url": "https://nanobanana.mcp.acedata.cloud/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "nano-banana-by-ace-data-cloud": {
            "command": "uvx",
            "args": [
                "mcp-nanobanana-pro"
            ],
            "env": {
                "ACEDATACLOUD_API_TOKEN": "<ACEDATACLOUD_API_TOKEN>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-nanobanana-pro <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "nano-banana-by-ace-data-cloud": {
            "type": "http",
            "url": "https://nanobanana.mcp.acedata.cloud/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "nano-banana-by-ace-data-cloud": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "mcp-nanobanana-pro"
            ],
            "env": {
                "ACEDATACLOUD_API_TOKEN": "<ACEDATACLOUD_API_TOKEN>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-nanobanana-pro <команда>

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http nano-banana-by-ace-data-cloud https://nanobanana.mcp.acedata.cloud/mcp
```

2. **Командой платформы**
```bash
gemini mcp add -e ACEDATACLOUD_API_TOKEN=<ACEDATACLOUD_API_TOKEN> nano-banana-by-ace-data-cloud uvx mcp-nanobanana-pro
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-nanobanana-pro <команда>

## Когда брать
- сгенерировать картинку по текстовому описанию, не выходя из чата с агентом
- объединить несколько изображений в одно по промпту
- примерить одежду на человека с фотографии
- поместить товар в реалистичную сцену
- узнать статус сразу нескольких задач генерации

## Примеры запросов агенту
- Сгенерируй через Nano Banana иллюстрацию для лендинга: плоский логотип кофейни на светлом фоне
- Отредактируй `hero.png` через `nanobanana_edit_image`: замени фон на закатное небо
- Проверь по сохранённому task ID, готова ли картинка в Nano Banana

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md