AceDataCloud/MCPNanoBanana

AceDataCloud/MCPNanoBanana

от acedatacloud
MCP сервер для генерации и редактирования изображений на базе Google Nano Banana. Создавайте картинки по тексту, редактируйте их, примеряйте одежду виртуально. Инструмент для дизайнеров и маркетоло...

Nano Banana by Ace Data Cloud

简体中文安装与首用指南

PyPI version PyPI downloads Python 3.10+ License: MIT MCP

A Model Context Protocol (MCP) server for AI image generation and editing using Google's Nano Banana model through the AceDataCloud API.

Generate and edit AI images directly from Claude, VS Code, or any MCP-compatible client.

Find the Nano Banana integration in the official MCP Registry

Open Nano Banana in the official MCP Registry, expand the matching io.github.AceDataCloud entry, and use its Packages or Remotes installation information in a client that consumes MCP catalogs. This is the Nano Banana integration provided by Ace Data Cloud; it is not an endorsement by the model vendor. The Registry is a directory, not the app that runs a tool.

Search for mcp-nanobanana-pro (or io.github.AceDataCloud/mcp-nanobanana-pro) to locate the exact entry. The official Registry search currently matches server names; spaces in a display title do not create extra search aliases. If your client does not consume the catalog, use the client-specific connection instructions below and check Applications → General application for your token, service permissions, balance and current price. Keep the original task ID when checking asynchronous results.

Инструменты были проиндексированы:
nanobanana_edit_image

Редактирует или объединяет изображения с помощью ИИ на основе текстового запроса. Это позволяет изменять существующие изображения или объединять несколько изображений вместе. Отлично подходит для виртуальной примерки, размещения товаров, улучшения изображений и многого другого. Используйте этот инструмент, когда: - Вы хотите объединить несколько изображений (например, человек + одежда) - Вы хотите изменить существующее изображение - Вам нужна виртуальная примерка (надеть одежду на человека) - Вы хотите разместить товары в разных сценах - Вам нужно изменить атрибуты (материалы, цвета, стили) Типичные сценарии использования: - Замена одежды на портрете: примерка разной одежды на одном человеке - Композиция сцены с товаром: размещение товаров в реалистичных окружениях - Замена атрибутов: изменение материалов, цветов или вариантов - Редактирование плакатов: быстрая смена стилей или тем - Преобразование 2D в 3D: преобразование изображений в 3D-макеты товаров - Восстановление изображений: восстановление старых или поврежденных фотографий Возвращает: Идентификатор задачи, идентификатор трассировки и URL измененного изображения.

Параметры
  • aspect_ratioenum | null

    Соотношение сторон редактируемого изображения. Варианты: '1:1', '3:2', '2:3', '16:9', '9:16', '4:3', '3:4'. Если параметр не указан, модель определяет его по исходным изображениям.

  • callback_urlstring | null

    Необязательный URL обратного вызова для асинхронного получения результата.

  • countinteger | null

    Количество отредактированных изображений для генерации. По умолчанию: 1.

  • image_urlsstring[]обязательный

    Список URL изображений для редактирования. Могут быть HTTP/HTTPS URL (публично доступные) или изображения в кодировке Base64 (data:image/png;base64,...). При объединении нескольких изображений опишите их взаимосвязь в запросе.

  • modelenum

    Модель для редактирования. 'nano-banana' (по умолчанию, псевдоним gemini-2.5-flash-image) работает быстрее. 'nano-banana-2-lite' - облегчённый вариант. 'nano-banana-2' (псевдоним gemini-3.1-flash-image) даёт качество уровня pro на скорости flash. 'nano-banana-2.1' поддерживает генерацию и редактирование в 1K/2K/4K. 'nano-banana-pro' (псевдоним gemini-3-pro-image) даёт наивысшее качество. У существующих моделей nano-banana, 2-lite, 2 и pro есть варианты с ':official'; у 2.1 их нет.

  • promptstringобязательный

    Описание редактирования, которое нужно выполнить. Опишите, как изображения нужно объединить или изменить. Пример: «оденьте этого человека в эту футболку», «поместите этот товар в сцену современной кухни».

  • resolutionenum | null

    Разрешение отредактированного изображения. Варианты: '1K', '2K', '4K'. Поддерживается в nano-banana-2, nano-banana-2.1 и nano-banana-pro.

nanobanana_generate_image

Генерирует AI-изображение из текстового запроса с помощью модели Google Nano Banana. Создаёт высококачественные изображения на основе подробных текстовых описаний. Чем детальнее ваш запрос, тем лучше результат. Используйте это, когда: - Вы хотите создать новое изображение с нуля - У вас есть подробное описание желаемого изображения - Вам нужна фотореалистичная или художественная генерация изображения Советы по написанию запроса: - Включайте: Основной объект + Атмосфера + Освещение + Камера/Объектив + Ключевые слова качества - Пример: "Urban career woman, backlit sunlight, film grain, orange-gold tones, hopeful dawn" Возвращает: Task ID, trace ID и URL сгенерированного изображения.

Параметры
  • aspect_ratioenum

    Соотношение сторон генерируемого изображения. Варианты: '1:1' (квадрат, по умолчанию), '3:2', '2:3', '16:9' (горизонтальное), '9:16' (вертикальное), '4:3', '3:4'.

  • callback_urlstring | null

    Необязательный URL обратного вызова для асинхронного получения результата.

  • countinteger | null

    Количество изображений для генерации. По умолчанию: 1.

  • modelenum

    Модель для генерации. 'nano-banana' (по умолчанию, алиас gemini-2.5-flash-image) работает быстрее. 'nano-banana-2-lite' - облегчённый вариант. 'nano-banana-2' (алиас gemini-3.1-flash-image) даёт качество уровня pro на скорости flash. 'nano-banana-2.1' поддерживает генерацию и редактирование в 1K/2K/4K. 'nano-banana-pro' (алиас gemini-3-pro-image) даёт наивысшее качество и поддерживает параметр resolution. У существующих моделей nano-banana, 2-lite, 2 и pro есть варианты ':official'; у 2.1 - нет.

  • promptstringобязательный

    Описание изображения для генерации. Будьте подробны в описании объекта, атмосферы, освещения, камеры/объектива и качества. Пример: «Фотореалистичный крупный план пожилого японского керамиста с глубокими морщинами и тёплой улыбкой, мягкий золотой час света, портретный объектив 85 мм, размытый фон»

  • resolutionenum | null

    Разрешение сгенерированного изображения. Варианты: '1K' (по умолчанию), '2K', '4K'. Поддерживается в nano-banana-2, nano-banana-2.1 и nano-banana-pro.

nanobanana_get_task

Запрашивает статус и результат задачи генерации или редактирования изображения. Используйте этот инструмент, чтобы проверить, завершена ли генерация или редактирование, и получить URL-адреса и метаданные результирующего изображения. Используйте, когда: - Нужно проверить, завершилась ли генерация изображения - Нужно получить URL-адреса изображений из предыдущей генерации - Нужно получить полные сведения о сгенерированном или отредактированном изображении Возвращает: Статус задачи и информацию об изображении, включая URL-адреса и prompts.

Параметры
  • task_idstringобязательный

    Идентификатор задачи, возвращаемый из запроса на генерацию или редактирование. Это поле 'task_id' из ответа любого инструмента nanobanana_generate_image или nanobanana_edit_image.

nanobanana_get_tasks_batch

Запрашивает множество задач генерации/редактирования изображений за один раз. Эффективно проверяет статус нескольких задач в одном запросе. Более эффективно, чем многократный вызов nanobanana_get_task. Используйте это, когда: - У вас есть несколько ожидающих генераций для проверки - Вы хотите получить статус нескольких изображений сразу - Вы отслеживаете пакет генераций Возвращает: Статус и информацию об изображениях для всех запрошенных задач.

Параметры
  • task_idsstring[]обязательный

    Список идентификаторов задач для запроса. Позволяет запрашивать несколько задач одновременно.

2026.10.19.5основная
2026.10.19.4
2026.10.19.3
2026.10.19.2
2026.10.19.1
2026.10.19.0
2026.10.18.6
2026.10.18.5
2026.10.18.4
2026.10.18.3
2026.10.18.2
2026.10.18.1
2026.10.18.0
2026.10.12.1
2026.10.12.0
2026.10.9.1
2026.10.9.0
2026.10.8.0
2026.10.7.1
2026.10.7.0
2026.10.6.0
2026.10.5.0
2026.10.4.1
2026.10.4.0
2026.9.30.0
2026.9.29.0
2026.9.5.0
2026.8.28.0
2026.8.24.0
2026.8.23.0
2026.8.18.0
2026.8.17.0
2026.8.15.0
2026.8.10.0
2026.7.31.0
2026.7.30.0
2026.7.4.1
2026.7.4.0
2026.7.2.1
2026.7.2.0
2026.6.9.4
2026.6.9.3
2026.6.9.2
2026.6.9.1
2026.6.9.0
2026.6.6.0
2026.5.31.2
2026.5.31.1
2026.5.31.0
2026.5.25.0
2026.5.24.0
2026.5.14.0
2026.4.30.0
2026.4.8.4
2026.4.8.3
2026.4.8.2
2026.4.8.1
2026.4.8.0
2026.4.5.6
2026.4.5.5
2026.4.5.4
2026.4.5.3
2026.4.5.2
2026.4.5.1
2026.4.5.0
2026.3.23.0
2026.3.22.1
2026.3.22.0
2026.3.21.10
2026.3.21.9
2026.3.21.8
2026.3.21.7
2026.3.21.6
2026.3.21.5
2026.3.21.4
2026.3.21.3
2026.3.21.2
2026.3.21.1
2026.3.21.0
2026.3.20.4
2026.3.20.3
2026.3.20.2
2026.3.20.1
2026.3.20.0
2026.3.19.9
2026.3.19.8
2026.3.19.7
2026.3.19.6
2026.3.19.5
2026.3.19.4
2026.3.19.3
2026.3.19.2
2026.3.19.1
2026.3.19.0
2026.3.9.1
2026.3.9.0
2026.3.8.3
2026.3.8.2
2026.3.8.1
2026.3.8.0
2026.3.1.2
2026.3.1.1
2026.3.1.0
2026.2.28.0
2026.2.15.3
2026.2.15.2
2026.2.15.1
2026.2.15.0
2026.1.25.0
2026.1.24.2
2026.1.24.1
2026.1.24.0
2026.1.22.0

Выберите клиент, чтобы установить AceDataCloud/MCPNanoBanana:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "acedatacloud-mcpnanobanana-1uq0zvqvis": {
      "command": "uvx",
      "args": [
        "mcp-nanobanana-pro"
      ],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your_token_here"
      }
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "acedatacloud-mcpnanobanana-1uq0zvqvis": {
      "command": "uvx",
      "args": [
        "mcp-nanobanana-pro"
      ],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your_token_here"
      }
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "acedatacloud-mcpnanobanana-1uq0zvqvis": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-nanobanana-pro"
      ],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your_token_here"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"acedatacloud-mcpnanobanana-1uq0zvqvis\",\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"mcp-nanobanana-pro\"],\"env\":{\"ACEDATACLOUD_API_TOKEN\":\"your_token_here\"}}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

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

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "acedatacloud-mcpnanobanana-1uq0zvqvis": {
      "command": "uvx",
      "args": [
        "mcp-nanobanana-pro"
      ],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your_token_here"
      }
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add acedatacloud-mcpnanobanana-1uq0zvqvis --env ACEDATACLOUD_API_TOKEN=your_token_here -- uvx mcp-nanobanana-pro

Либо через JSON-конфиг:

claude mcp add-json acedatacloud-mcpnanobanana-1uq0zvqvis "{\"command\":\"uvx\",\"args\":[\"mcp-nanobanana-pro\"],\"env\":{\"ACEDATACLOUD_API_TOKEN\":\"your_token_here\"}}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add acedatacloud-mcpnanobanana-1uq0zvqvis --env ACEDATACLOUD_API_TOKEN=your_token_here -- uvx mcp-nanobanana-pro

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.acedatacloud-mcpnanobanana-1uq0zvqvis]
command = "uvx"
args = ["mcp-nanobanana-pro"]

[mcp_servers.acedatacloud-mcpnanobanana-1uq0zvqvis.env]
ACEDATACLOUD_API_TOKEN = "your_token_here"
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите AceDataCloud/MCPNanoBanana, а в поле команды запуска — строку ниже:
uvx mcp-nanobanana-pro

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "acedatacloud-mcpnanobanana-1uq0zvqvis": {
      "command": "uvx",
      "args": [
        "mcp-nanobanana-pro"
      ],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your_token_here"
      }
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "acedatacloud-mcpnanobanana-1uq0zvqvis": {
      "command": "uvx",
      "args": [
        "mcp-nanobanana-pro"
      ],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your_token_here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например acedatacloud-mcpnanobanana-1uq0zvqvis.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: acedatacloud-mcpnanobanana-1uq0zvqvis
    command: uvx
    args:
      - "mcp-nanobanana-pro"
    env:
      ACEDATACLOUD_API_TOKEN: your_token_here
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "acedatacloud-mcpnanobanana-1uq0zvqvis": {
      "command": "uvx",
      "args": [
        "mcp-nanobanana-pro"
      ],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your_token_here"
      }
    }
  }
}

Похожие MCP-сервера

nanana-app/mcp-server-nano-banana

nanana-app/mcp-server-nano-banana

от nanana-app

MCP-сервер для генерации и трансформации изображений через Nanana AI с моделью Google Gemini nano banana. Позволяет Claude Desktop создавать картинки по тексту и редактировать существующие. Полезен...

JavaScript⭐ 10
AceDataCloud/MCPFlux

AceDataCloud/MCPFlux

от acedatacloud

MCP сервер FluxMCP подключает генерацию и редактирование AI-изображений Flux к любым MCP-клиентам. Создавайте и дорабатывайте картинки текстовыми запросами, работайте локально или облачно, 7 моделей.

Python⭐ 3
forgemeshlabs/imagegen-mcp

forgemeshlabs/imagegen-mcp

от forgemeshlabs

MCP сервер для генерации изображений с оплатой в USDC через x402. Создавайте картинки, удаляйте фон и повышайте разрешение до 4K без API ключа. Вызов одним запросом - для автономных агентов и разра...

JavaScript⭐ 1
AceDataCloud/MCPSeedream

AceDataCloud/MCPSeedream

от acedatacloud

MCP-сервер для генерации и редактирования изображений с помощью моделей ByteDance Seedream. Используйте текстовые запросы на русском или английском, меняйте стиль и фон, управляйте разрешением и se...

Python⭐ 3
Amazon Bedrock Nova Canvas

Amazon Bedrock Nova Canvas

от zxkane

MCP сервер для генерации изображений через Amazon Bedrock и модель Nova Canvas. Создает качественные картинки по тексту, поддерживает негативные промпты, настройку разрешения и seed. Полезен разработчикам AI-решений на AWS.

JavaScript⭐ 25
j-east/pixel-surgeon-mcp

j-east/pixel-surgeon-mcp

от j-east

MCP-сервер для генерации и редактирования изображений и видео через Gemini, OpenAI, Grok и Veo 3. Позволяет восстанавливать испорченный текст, менять фон и создавать видео по текстовым запросам. По...

JavaScript⭐ 5
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин