Nano Banana MCP Инструкция по интеграции

MCP (Model Context Protocol) — это протокол контекста модели, разработанный Anthropic, который позволяет AI моделям (таким как Claude, GPT и др.) вызывать внешние инструменты через стандартизированный интерфейс. С помощью Nano Banana MCP Server, предоставляемого AceData Cloud, вы можете напрямую генерировать и редактировать AI изображения в таких AI клиентах, как Claude Desktop, VS Code, Cursor и др.

Обзор функций

Nano Banana MCP Server предоставляет следующие основные функции:

Генерация изображений — создание высококачественных изображений по текстовым подсказкам
Редактирование изображений — изменение существующих изображений или комбинирование нескольких изображений
Виртуальная примерка — наложение одежды на фотографии людей
Продуктовая интеграция — размещение продуктов в реальных сценах
Поддержка нескольких моделей — поддержка моделей nano-banana, nano-banana-2 и nano-banana-pro
Запросы задач — мониторинг процесса генерации и получение результатов

Предварительная подготовка

Перед использованием вам необходимо получить AceData Cloud API Token:

Зарегистрируйтесь или войдите на платформу AceData Cloud
Перейдите на страницу Nano Banana Images API
Нажмите «Acquire», чтобы получить API Token (первый запрос предоставляет бесплатный лимит)

Установка и настройка

Способ 1: Установка через pip (рекомендуется)

pip install mcp-nanobanana-pro

Способ 2: Установка из исходников

git clone https://github.com/AceDataCloud/NanoBananaMCP.git
cd NanoBananaMCP
pip install -e .

После завершения установки вы можете использовать команду mcp-nanobanana-pro для запуска сервиса.

Использование в Claude Desktop

Отредактируйте файл конфигурации Claude Desktop:

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

Добавьте следующую конфигурацию:

{
  "mcpServers": {
    "nanobanana": {
      "command": "mcp-nanobanana-pro",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "ваш API Token"
      }
    }
  }
}

Если вы используете uvx (не требует предварительной установки пакета):

{
  "mcpServers": {
    "nanobanana": {
      "command": "uvx",
      "args": ["mcp-nanobanana-pro"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "ваш API Token"
      }
    }
  }
}

Сохраните конфигурацию и перезапустите Claude Desktop, чтобы использовать инструменты Nano Banana в диалоге.

Использование в VS Code / Cursor

Создайте файл .vscode/mcp.json в корневом каталоге проекта:

{
  "servers": {
    "nanobanana": {
      "command": "mcp-nanobanana-pro",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "ваш API Token"
      }
    }
  }
}

Или используйте uvx:

{
  "servers": {
    "nanobanana": {
      "command": "uvx",
      "args": ["mcp-nanobanana-pro"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "ваш API Token"
      }
    }
  }
}

Список доступных инструментов

Название инструмента	Описание
`nanobanana_generate_image`	Генерация изображений по текстовым подсказкам
`nanobanana_edit_image`	Редактирование или комбинирование существующих изображений
`nanobanana_get_task`	Запрос статуса одной задачи
`nanobanana_get_tasks_batch`	Пакетный запрос статусов задач

Примеры использования

После завершения настройки вы можете напрямую вызывать эти функции на естественном языке в AI клиенте, например:

«Помоги мне сгенерировать акварельный пейзаж»
«Наложи эту одежду на этого человека»
«Помести этот продукт в сцену кафе»
«Сгенерируй высококачественный портрет с помощью модели nano-banana-pro»

Дополнительная информация

Репозиторий на GitHub: AceDataCloud/NanoBananaMCP
Пакет PyPI: mcp-nanobanana-pro
Документация API: Nano Banana API

​Обзор функций

​Предварительная подготовка

​Установка и настройка

​Способ 1: Установка через pip (рекомендуется)

​Способ 2: Установка из исходников

​Использование в Claude Desktop

​Использование в VS Code / Cursor

​Список доступных инструментов

​Примеры использования

​Дополнительная информация