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

# Guide d'intégration Midjourney MCP

> midjourney MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) est un protocole de contexte de modèle lancé par Anthropic, permettant aux modèles d'IA (comme Claude, GPT, etc.) d'appeler des outils externes via une interface standardisée. Grâce au Midjourney MCP Server fourni par XHuoAPI, vous pouvez générer et éditer directement des images AI dans des clients AI tels que Claude Desktop, VS Code, Cursor, etc.

## Vue d'ensemble des fonctionnalités

Le Midjourney MCP Server offre les fonctionnalités principales suivantes :

* **Génération d'images (Imagine)** — Générer des images de haute qualité à partir de mots-clés textuels
* **Édition d'images** — Modifier localement des images déjà générées
* **Transformation d'images** — Agrandir, réduire, déplacer des images existantes
* **Mélange d'images (Blend)** — Fusionner plusieurs images en une nouvelle image
* **Génération d'images de référence** — Utiliser des images de référence pour guider la génération
* **Description d'images (Describe)** — Générer une description textuelle à partir d'une image
* **Traduction de mots-clés** — Traduire des mots-clés en chinois vers l'anglais
* **Obtention de graines** — Obtenir la valeur seed d'une image pour la reproduire
* **Génération de vidéos** — Générer des vidéos dynamiques basées sur des images
* **Consultation de tâches** — Surveiller l'avancement de la génération et obtenir des résultats

## Préparations préalables

Avant d'utiliser, vous devez obtenir un token API XHuoAPI :

1. Inscrivez-vous ou connectez-vous à la [plateforme XHuoAPI](https://api.xhuoapi.ai)
2. Allez à la page [Midjourney Imagine API](https://api.xhuoapi.ai/documents/midjourney-imagine)
3. Cliquez sur « Acquire » pour obtenir un token API (première demande avec un quota gratuit)

## Installation et configuration

### Méthode 1 : Installation via pip (recommandée)

```bash theme={null}
pip install mcp-midjourney
```

### Méthode 2 : Installation à partir du code source

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

Une fois l'installation terminée, vous pouvez démarrer le service avec la commande `mcp-midjourney`.

## Utilisation dans Claude Desktop

Éditez le fichier de configuration de Claude Desktop :

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

Ajoutez la configuration suivante :

```json theme={null}
{
  "mcpServers": {
    "midjourney": {
      "command": "mcp-midjourney",
      "env": {
        "XHuoAPI_API_TOKEN": "votre token API"
      }
    }
  }
}
```

Si vous utilisez `uvx` (pas besoin d'installer le package à l'avance) :

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

Après avoir enregistré la configuration, redémarrez Claude Desktop pour pouvoir utiliser les outils liés à Midjourney dans la conversation.

## Utilisation dans VS Code / Cursor

Créez un fichier `.vscode/mcp.json` dans le répertoire racine du projet :

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

Ou utilisez `uvx` :

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

## Liste des outils disponibles

| Nom de l'outil               | Description                                            |
| ---------------------------- | ------------------------------------------------------ |
| `midjourney_imagine`         | Générer des images à partir de mots-clés textuels      |
| `midjourney_edit`            | Éditer des zones locales d'images existantes           |
| `midjourney_transform`       | Agrandir, réduire, déplacer des images existantes      |
| `midjourney_blend`           | Fusionner plusieurs images en une seule                |
| `midjourney_with_reference`  | Générer des images à partir d'images de référence      |
| `midjourney_describe`        | Générer une description textuelle à partir d'une image |
| `midjourney_translate`       | Traduire des mots-clés en anglais                      |
| `midjourney_get_seed`        | Obtenir la valeur seed d'une image                     |
| `midjourney_generate_video`  | Générer des vidéos à partir d'images                   |
| `midjourney_extend_video`    | Prolonger une vidéo existante                          |
| `midjourney_get_task`        | Consulter l'état d'une tâche unique                    |
| `midjourney_get_tasks_batch` | Consulter l'état de plusieurs tâches                   |

## Exemples d'utilisation

Une fois la configuration terminée, vous pouvez directement appeler ces fonctionnalités en langage naturel dans le client AI, par exemple :

* « Aide-moi à générer une image d'une ville nocturne de style cyberpunk »
* « Change l'arrière-plan de cette image en bord de mer »
* « Mélange ces quatre images en une seule »
* « Décris le contenu de cette image »
* « Transforme cette image en vidéo »
* « Agrandis la deuxième variante de cette image »

## Plus d'informations

* Dépôt GitHub : [XHuoAPI/MidjourneyMCP](https://github.com/XHuoAPI/MidjourneyMCP)
* Package PyPI : [mcp-midjourney](https://pypi.org/project/mcp-midjourney/)
* Documentation API : [API de génération Midjourney](https://api.xhuoapi.ai/documents/midjourney)