> ## 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.

# Nano Banana MCP Інтеграційний посібник

> nanobanana MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) — це протокол контексту моделі, представлений компанією 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](https://api.xhuoapi.ai)
2. Перейдіть на сторінку [Nano Banana Images API](https://api.xhuoapi.ai/documents/nano-banana-images)
3. Натисніть «Acquire», щоб отримати API Token (перший запит надає безкоштовний ліміт)

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

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

```bash theme={null}
pip install mcp-nanobanana-pro
```

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

```bash theme={null}
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`

Додайте наступну конфігурацію:

```json theme={null}
{
  "mcpServers": {
    "nanobanana": {
      "command": "mcp-nanobanana-pro",
      "env": {
        "XHuoAPI_API_TOKEN": "ваш API Token"
      }
    }
  }
}
```

Якщо ви використовуєте `uvx` (не потрібно попередньо встановлювати пакет):

```json theme={null}
{
  "mcpServers": {
    "nanobanana": {
      "command": "uvx",
      "args": ["mcp-nanobanana-pro"],
      "env": {
        "XHuoAPI_API_TOKEN": "ваш API Token"
      }
    }
  }
}
```

Збережіть конфігурацію та перезапустіть Claude Desktop, щоб використовувати інструменти Nano Banana в діалозі.

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

У кореневій директорії проекту створіть `.vscode/mcp.json`:

```json theme={null}
{
  "servers": {
    "nanobanana": {
      "command": "mcp-nanobanana-pro",
      "env": {
        "XHuoAPI_API_TOKEN": "ваш API Token"
      }
    }
  }
}
```

Або використовуйте `uvx`:

```json theme={null}
{
  "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»

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

* Репозиторій GitHub: [XHuoAPI/NanoBananaMCP](https://github.com/XHuoAPI/NanoBananaMCP)
* Пакет PyPI: [mcp-nanobanana-pro](https://pypi.org/project/mcp-nanobanana-pro/)
* Документація API: [Nano Banana API](https://api.xhuoapi.ai/documents/nano-banana)