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

# Midjourney MCP Integrationsanleitung

> midjourney 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 Midjourney MCP Server kannst du direkt in KI-Clients wie Claude Desktop, VS Code, Cursor usw. KI-Bilder generieren und bearbeiten.

## Funktionsübersicht

Der Midjourney MCP Server bietet folgende Kernfunktionen:

* **Bildgenerierung (Imagine)** — Hochwertige Bilder durch Texteingaben generieren
* **Bildbearbeitung** — Teilweise Änderungen an bereits generierten Bildern vornehmen
* **Bildtransformation** — Vorhandene Bilder vergrößern, verkleinern oder verschieben
* **Bildmischung (Blend)** — Mehrere Bilder zu einem neuen Bild verschmelzen
* **Referenzbildgenerierung** — Generierung unter Verwendung von Referenzbildern
* **Bildbeschreibung (Describe)** — Textbeschreibungen basierend auf Bildern erstellen
* **Prompt-Übersetzung** — Chinesische Eingaben ins Englische übersetzen
* **Seed-Abruf** — Den Seed-Wert eines Bildes abrufen, um es zu reproduzieren
* **Videogenerierung** — Dynamische Videos basierend auf Bildern erstellen
* **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 [Midjourney Imagine API](https://api.xhuoapi.ai/documents/midjourney-imagine) Seite
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-midjourney
```

### Methode 2: Quellcode-Installation

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

Nach der Installation kannst du den Dienst mit dem Befehl `mcp-midjourney` 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": {
    "midjourney": {
      "command": "mcp-midjourney",
      "env": {
        "XHuoAPI_API_TOKEN": "dein API Token"
      }
    }
  }
}
```

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

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

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

## Verwendung in VS Code / Cursor

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

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

Oder verwende `uvx`:

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

## Verfügbare Werkzeugliste

| Werkzeugname                 | Beschreibung                                               |
| ---------------------------- | ---------------------------------------------------------- |
| `midjourney_imagine`         | Bilder durch Texteingaben generieren                       |
| `midjourney_edit`            | Teilbereiche vorhandener Bilder bearbeiten                 |
| `midjourney_transform`       | Vorhandene Bilder vergrößern, verkleinern oder verschieben |
| `midjourney_blend`           | Mehrere Bilder zu einem Bild mischen                       |
| `midjourney_with_reference`  | Bilder unter Verwendung von Referenzbildern generieren     |
| `midjourney_describe`        | Textbeschreibungen basierend auf Bildern erstellen         |
| `midjourney_translate`       | Eingaben ins Englische übersetzen                          |
| `midjourney_get_seed`        | Den Seed-Wert eines Bildes abrufen                         |
| `midjourney_generate_video`  | Videos basierend auf Bildern erstellen                     |
| `midjourney_extend_video`    | Vorhandene Videos verlängern                               |
| `midjourney_get_task`        | Status einer einzelnen Aufgabe abfragen                    |
| `midjourney_get_tasks_batch` | Status mehrerer Aufgaben abfragen                          |

## Nutzung Beispiele

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

* „Hilf mir, ein Cyberpunk-Stadtbild bei Nacht zu generieren“
* „Ändere den Hintergrund dieses Bildes in einen Strand“
* „Mische diese vier Bilder zu einem“
* „Beschreibe den Inhalt dieses Bildes“
* „Mach ein Video aus diesem Bild“
* „Vergrößere die zweite Variante dieses Bildes“

## Weitere Informationen

* GitHub Repository: [XHuoAPI/MidjourneyMCP](https://github.com/XHuoAPI/MidjourneyMCP)
* PyPI Paket: [mcp-midjourney](https://pypi.org/project/mcp-midjourney/)
* API Dokumentation: [Midjourney Generierungs-API](https://api.xhuoapi.ai/documents/midjourney)