Перейти к основному содержанию

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»

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