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

> nanobanana MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) ist ein von Anthropic eingeführtes Modellkontextprotokoll, das es KI-Modellen (wie Claude, GPT usw.) ermöglicht, externe Werkzeuge über standardisierte Schnittstellen aufzurufen. Über den von XHuoAPI bereitgestellten Nano Banana MCP Server kannst du direkt in AI-Clients wie Claude Desktop, VS Code, Cursor usw. KI-Bilder generieren und bearbeiten.

## Funktionsübersicht

Der Nano Banana MCP Server bietet folgende Kernfunktionen:

* **Bildgenerierung** — Hochwertige Bilder durch Texteingaben generieren
* **Bildbearbeitung** — Vorhandene Bilder ändern oder mehrere Bilder kombinieren
* **Virtuelles Anprobieren** — Kleidung auf Personenfotos anbringen
* **Produktplatzierung** — Produkte in realen Szenen platzieren
* **Mehrmodellunterstützung** — Unterstützung für die Modelle nano-banana, nano-banana-2 und nano-banana-pro
* **Aufgabenabfrage** — Überwachung des Generierungsfortschritts und Abruf der Ergebnisse

## Vorbereitungen

Vor der Nutzung musst du ein XHuoAPI API Token erhalten:

1. Registriere dich oder melde dich bei der [XHuoAPI Plattform](https://api.xhuoapi.ai) an
2. Gehe zur Seite [Nano Banana Images API](https://api.xhuoapi.ai/documents/nano-banana-images)
3. Klicke auf „Acquire“, um ein API Token zu erhalten (bei der ersten Anfrage gibt es ein kostenloses Kontingent)

## Installation und Konfiguration

### Methode 1: pip Installation (empfohlen)

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

### Methode 2: Quellcodeinstallation

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

Nach der Installation kannst du den Dienst mit dem Befehl `mcp-nanobanana-pro` starten.

## Verwendung in Claude Desktop

Bearbeite die Konfigurationsdatei von Claude Desktop:

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

Füge die folgende Konfiguration hinzu:

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

Wenn du `uvx` verwendest (keine vorherige Installation erforderlich):

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

Speichere die Konfiguration und starte Claude Desktop neu, um die Nano Banana-Tools im Dialog zu verwenden.

## Verwendung in VS Code / Cursor

Erstelle im Stammverzeichnis des Projekts die Datei `.vscode/mcp.json`:

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

Oder verwende `uvx`:

```json theme={null}
{
  "servers": {
    "nanobanana": {
      "command": "uvx",
      "args": ["mcp-nanobanana-pro"],
      "env": {
        "XHuoAPI_API_TOKEN": "dein API Token"
      }
    }
  }
}
```

## Verfügbare Werkzeugliste

| Werkzeugname                 | Beschreibung                                  |
| ---------------------------- | --------------------------------------------- |
| `nanobanana_generate_image`  | Bilder durch Texteingaben generieren          |
| `nanobanana_edit_image`      | Vorhandene Bilder bearbeiten oder kombinieren |
| `nanobanana_get_task`        | Status eines einzelnen Auftrags abfragen      |
| `nanobanana_get_tasks_batch` | Status mehrerer Aufträge abfragen             |

## Nutzung Beispiele

Nach der Konfiguration kannst du diese Funktionen direkt in der KI-Client-Anwendung mit natürlicher Sprache aufrufen, zum Beispiel:

* „Hilf mir, ein Aquarellbild einer Landschaft zu generieren“
* „Füge dieses Kleidungsstück auf dieses Bild ein“
* „Platziere dieses Produkt in einer Cafészene“
* „Generiere ein hochwertiges Porträt mit dem Modell nano-banana-pro“

## Weitere Informationen

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