> ## 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 Przewodnik po integracji

> nanobanana MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) to protokół kontekstu modelu wprowadzony przez Anthropic, który pozwala modelom AI (takim jak Claude, GPT itp.) na wywoływanie zewnętrznych narzędzi za pomocą znormalizowanego interfejsu. Dzięki serwerowi Nano Banana MCP udostępnionemu przez XHuoAPI, możesz bezpośrednio generować i edytować obrazy AI w klientach AI, takich jak Claude Desktop, VS Code, Cursor itp.

## Przegląd funkcji

Serwer Nano Banana MCP oferuje następujące kluczowe funkcje:

* **Generowanie obrazów** — generowanie wysokiej jakości obrazów na podstawie tekstowych wskazówek
* **Edycja obrazów** — modyfikowanie istniejących obrazów lub łączenie wielu obrazów
* **Wirtualne przymierzanie** — zakładanie odzieży na zdjęcia postaci
* **Wstawianie produktów** — umieszczanie produktów w rzeczywistych scenach
* **Wsparcie dla wielu modeli** — obsługuje modele nano-banana, nano-banana-2 i nano-banana-pro
* **Zapytania o zadania** — monitorowanie postępu generowania i uzyskiwanie wyników

## Wymagania wstępne

Przed użyciem musisz uzyskać token API XHuoAPI:

1. Zarejestruj się lub zaloguj na [platformie XHuoAPI](https://api.xhuoapi.ai)
2. Przejdź do strony [Nano Banana Images API](https://api.xhuoapi.ai/documents/nano-banana-images)
3. Kliknij „Acquire”, aby uzyskać token API (pierwsze zgłoszenie daje darmowy limit)

## Instalacja i konfiguracja

### Metoda 1: instalacja pip (zalecana)

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

### Metoda 2: instalacja ze źródła

```bash theme={null}
git clone https://github.com/XHuoAPI/NanoBananaMCP.git
cd NanoBananaMCP
pip install -e .
```

Po zakończeniu instalacji możesz uruchomić serwis za pomocą polecenia `mcp-nanobanana-pro`.

## Użycie w Claude Desktop

Edytuj plik konfiguracyjny Claude Desktop:

* **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
* **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

Dodaj następującą konfigurację:

```json theme={null}
{
  "mcpServers": {
    "nanobanana": {
      "command": "mcp-nanobanana-pro",
      "env": {
        "XHuoAPI_API_TOKEN": "twój token API"
      }
    }
  }
}
```

Jeśli używasz `uvx` (nie wymaga wcześniejszej instalacji pakietu):

```json theme={null}
{
  "mcpServers": {
    "nanobanana": {
      "command": "uvx",
      "args": ["mcp-nanobanana-pro"],
      "env": {
        "XHuoAPI_API_TOKEN": "twój token API"
      }
    }
  }
}
```

Po zapisaniu konfiguracji uruchom ponownie Claude Desktop, aby móc korzystać z narzędzi związanych z Nano Banana w rozmowie.

## Użycie w VS Code / Cursor

Utwórz plik `.vscode/mcp.json` w katalogu głównym projektu:

```json theme={null}
{
  "servers": {
    "nanobanana": {
      "command": "mcp-nanobanana-pro",
      "env": {
        "XHuoAPI_API_TOKEN": "twój token API"
      }
    }
  }
}
```

Lub użyj `uvx`:

```json theme={null}
{
  "servers": {
    "nanobanana": {
      "command": "uvx",
      "args": ["mcp-nanobanana-pro"],
      "env": {
        "XHuoAPI_API_TOKEN": "twój token API"
      }
    }
  }
}
```

## Lista dostępnych narzędzi

| Nazwa narzędzia              | Opis                                                  |
| ---------------------------- | ----------------------------------------------------- |
| `nanobanana_generate_image`  | Generowanie obrazów na podstawie tekstowych wskazówek |
| `nanobanana_edit_image`      | Edytowanie lub łączenie istniejących obrazów          |
| `nanobanana_get_task`        | Zapytanie o status pojedynczego zadania               |
| `nanobanana_get_tasks_batch` | Zapytanie o status zadań w partii                     |

## Przykłady użycia

Po skonfigurowaniu możesz bezpośrednio wywoływać te funkcje w kliencie AI za pomocą naturalnego języka, na przykład:

* „Pomóż mi wygenerować obraz w stylu akwareli przedstawiający krajobraz górski”
* „Nałóż tę odzież na tę osobę w Photoshopie”
* „Umieść ten produkt w scenerii kawiarni”
* „Wygeneruj wysokiej jakości portret za pomocą modelu nano-banana-pro”

## Więcej informacji

* Repozytorium GitHub: [XHuoAPI/NanoBananaMCP](https://github.com/XHuoAPI/NanoBananaMCP)
* Pakiet PyPI: [mcp-nanobanana-pro](https://pypi.org/project/mcp-nanobanana-pro/)
* Dokumentacja API: [Nano Banana API](https://api.xhuoapi.ai/documents/nano-banana)