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

# Flux MCP Integrationsanleitung

> flux MCP 服务器集成

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

## Funktionsübersicht

Der Flux MCP Server bietet folgende Kernfunktionen:

* **Text-zu-Bild-Generierung** — Erzeugung hochwertiger Bilder anhand von Text-Prompts
* **Bildbearbeitung** — Bearbeitung bestehender Bilder basierend auf Textanweisungen
* **Multi-Modell-Unterstützung** — Unterstützung verschiedener Modelle wie Flux Pro, Flux Dev, Flux Schnell, Flux Kontext usw.
* **Modellabfrage** — Anzeige aller verfügbaren Modelle und deren Fähigkeiten
* **Aufgabenabfrage** — Überwachung des Generierungsfortschritts und Abruf der Ergebnisse

## Voraussetzungen

Vor der Nutzung benötigst du einen XHuoAPI API Token:

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

## Installation und Konfiguration

### Methode 1: Installation via pip (empfohlen)

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

### Methode 2: Installation aus dem Quellcode

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

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

## Nutzung 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 folgende Konfiguration hinzu:

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

Wenn du `uvx` verwenden möchtest (kein vorheriges Installieren von Paketen erforderlich):

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

Speichere die Konfiguration und starte Claude Desktop neu, um die Flux-Tools im Chat verwenden zu können.

## Nutzung in VS Code / Cursor

Erstelle im Projektstammverzeichnis die Datei `.vscode/mcp.json`:

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

Alternativ mit `uvx`:

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

## Verfügbare Tools

| Toolname               | Beschreibung                                              |
| ---------------------- | --------------------------------------------------------- |
| `flux_generate_image`  | Generiert Bilder anhand von Text-Prompts                  |
| `flux_edit_image`      | Bearbeitet bestehende Bilder per Textanweisung            |
| `flux_get_task`        | Abfrage des Status einer einzelnen Aufgabe                |
| `flux_get_tasks_batch` | Batch-Abfrage mehrerer Aufgabenstatus                     |
| `flux_list_models`     | Listet alle verfügbaren Modelle und deren Fähigkeiten auf |
| `flux_list_actions`    | Listet alle verfügbaren Tools und Workflow-Beispiele auf  |

## Anwendungsbeispiele

Nach der Konfiguration kannst du diese Funktionen direkt in deinem AI-Client mit natürlicher Sprache aufrufen, z.B.:

* „Erstelle mir mit Flux ein Bild einer Cyberpunk-Stadt bei Nacht“
* „Ändere den Hintergrund dieses Fotos in einen Strand“
* „Bearbeite dieses Bild mit dem Flux Kontext Pro Modell und ändere die Farbe der Kleidung zu Rot“
* „Liste alle verfügbaren Flux-Modelle auf“

## Weitere Informationen

* GitHub Repository: [XHuoAPI/FluxMCP](https://github.com/XHuoAPI/FluxMCP)
* PyPI Paket: [mcp-flux-pro](https://pypi.org/project/mcp-flux-pro/)
* API Dokumentation: [Flux Bildgenerierungs-API](https://api.xhuoapi.ai/documents/flux)