Zum Hauptinhalt springen
MCP (Model Context Protocol) 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 AceData Cloud 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 AceData Cloud API Token:
  1. Registriere dich oder melde dich an auf der AceData Cloud Plattform
  2. Gehe zur Flux Images API 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)

pip install mcp-flux-pro

Methode 2: Installation aus dem Quellcode

git clone https://github.com/AceDataCloud/MCPFlux.git
cd MCPFlux
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:
{
  "mcpServers": {
    "flux": {
      "command": "mcp-flux-pro",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "dein API Token"
      }
    }
  }
}
Wenn du uvx verwenden möchtest (kein vorheriges Installieren von Paketen erforderlich):
{
  "mcpServers": {
    "flux": {
      "command": "uvx",
      "args": ["mcp-flux-pro"],
      "env": {
        "ACEDATACLOUD_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:
{
  "servers": {
    "flux": {
      "command": "mcp-flux-pro",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "dein API Token"
      }
    }
  }
}
Alternativ mit uvx:
{
  "servers": {
    "flux": {
      "command": "uvx",
      "args": ["mcp-flux-pro"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "dein API Token"
      }
    }
  }
}

Verfügbare Tools

ToolnameBeschreibung
flux_generate_imageGeneriert Bilder anhand von Text-Prompts
flux_edit_imageBearbeitet bestehende Bilder per Textanweisung
flux_get_taskAbfrage des Status einer einzelnen Aufgabe
flux_get_tasks_batchBatch-Abfrage mehrerer Aufgabenstatus
flux_list_modelsListet alle verfügbaren Modelle und deren Fähigkeiten auf
flux_list_actionsListet 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