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

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

​Приклади використання

​Додаткова інформація