Перейти до основного вмісту
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:
  1. Зареєструйтесь або увійдіть на платформу AceData Cloud
  2. Перейдіть на сторінку Nano Banana Images API
  3. Натисніть «Acquire», щоб отримати API Token (перший запит надає безкоштовний ліміт)

Встановлення та налаштування

Спосіб 1: Встановлення через pip (рекомендується)

pip install mcp-nanobanana-pro

Спосіб 2: Встановлення з вихідного коду

git clone https://github.com/AceDataCloud/MCPNanoBanana.git
cd MCPNanoBanana
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»

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