Перейти до основного вмісту

Documentation Index

Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
Огляд функцій

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

​
Попередня підготовка

Перед використанням вам потрібно отримати XHuoAPI API Token:
  1. Зареєструйтесь або увійдіть на платформу XHuoAPI
  2. Перейдіть на сторінку Nano Banana Images API
  3. Натисніть «Acquire», щоб отримати API Token (перший запит надає безкоштовний ліміт)

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

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

pip install mcp-nanobanana-pro

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

git clone https://github.com/XHuoAPI/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": {
        "XHuoAPI_API_TOKEN": "ваш API Token"
      }
    }
  }
}
Якщо ви використовуєте uvx (не потрібно попередньо встановлювати пакет): 
{
  "mcpServers": {
    "nanobanana": {
      "command": "uvx",
      "args": ["mcp-nanobanana-pro"],
      "env": {
        "XHuoAPI_API_TOKEN": "ваш API Token"
      }
    }
  }
}
Збережіть конфігурацію та перезапустіть Claude Desktop, щоб використовувати інструменти Nano Banana в діалозі.

​
Використання в VS Code / Cursor

У кореневій директорії проекту створіть .vscode/mcp.json: 
{
  "servers": {
    "nanobanana": {
      "command": "mcp-nanobanana-pro",
      "env": {
        "XHuoAPI_API_TOKEN": "ваш API Token"
      }
    }
  }
}
Або використовуйте uvx: 
{
  "servers": {
    "nanobanana": {
      "command": "uvx",
      "args": ["mcp-nanobanana-pro"],
      "env": {
        "XHuoAPI_API_TOKEN": "ваш API Token"
      }
    }
  }
}

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

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

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

Після налаштування ви можете безпосередньо викликати ці функції природною мовою в AI клієнті, наприклад:
  • «Допоможіть мені згенерувати акварельний пейзаж»
  • «Приклейте цей одяг до цієї людини»
  • «Розмістіть цей продукт у сцені кафе»
  • «Згенеруйте високоякісний портрет за допомогою моделі nano-banana-pro»

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