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

# Guida all'integrazione di Midjourney MCP

> midjourney MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) è un protocollo di contesto del modello lanciato da Anthropic, che consente ai modelli AI (come Claude, GPT, ecc.) di chiamare strumenti esterni tramite interfacce standardizzate. Attraverso il Midjourney MCP Server fornito da XHuoAPI, puoi generare e modificare direttamente immagini AI in client AI come Claude Desktop, VS Code, Cursor, ecc.

## Panoramica delle funzionalità

Il Midjourney MCP Server offre le seguenti funzionalità principali:

* **Generazione di immagini (Imagine)** — Genera immagini di alta qualità tramite suggerimenti testuali
* **Modifica delle immagini** — Effettua modifiche locali su immagini già generate
* **Trasformazione delle immagini** — Ingrandisci, riduci o sposta immagini esistenti
* **Fusione delle immagini (Blend)** — Combina più immagini in una nuova immagine
* **Generazione di immagini di riferimento** — Guida la generazione utilizzando immagini di riferimento
* **Descrizione delle immagini (Describe)** — Genera descrizioni testuali in base alle immagini
* **Traduzione dei suggerimenti** — Traduci suggerimenti in cinese in inglese
* **Acquisizione del seed** — Ottieni il valore seed dell'immagine per la riproduzione
* **Generazione di video** — Crea video dinamici basati su immagini
* **Query delle attività** — Monitora il progresso della generazione e ottieni risultati

## Preparazione preliminare

Prima di utilizzare, è necessario ottenere il token API di XHuoAPI:

1. Registrati o accedi alla [piattaforma XHuoAPI](https://api.xhuoapi.ai)
2. Vai alla pagina [Midjourney Imagine API](https://api.xhuoapi.ai/documents/midjourney-imagine)
3. Clicca su "Acquire" per ottenere il token API (il primo acquisto include un credito gratuito)

## Installazione e configurazione

### Metodo 1: installazione con pip (raccomandato)

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

### Metodo 2: installazione da sorgente

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

Dopo aver completato l'installazione, puoi avviare il servizio utilizzando il comando `mcp-midjourney`.

## Utilizzo in Claude Desktop

Modifica il file di configurazione di Claude Desktop:

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

Aggiungi la seguente configurazione:

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

Se utilizzi `uvx` (non è necessario installare pacchetti in anticipo):

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

Dopo aver salvato la configurazione, riavvia Claude Desktop per utilizzare gli strumenti relativi a Midjourney nella conversazione.

## Utilizzo in VS Code / Cursor

Crea `.vscode/mcp.json` nella directory principale del progetto:

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

Oppure utilizza `uvx`:

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

## Elenco degli strumenti disponibili

| Nome dello strumento         | Descrizione                                         |
| ---------------------------- | --------------------------------------------------- |
| `midjourney_imagine`         | Genera immagini tramite suggerimenti testuali       |
| `midjourney_edit`            | Modifica aree locali di immagini esistenti          |
| `midjourney_transform`       | Ingrandisci, riduci o sposta immagini esistenti     |
| `midjourney_blend`           | Combina più immagini in una sola                    |
| `midjourney_with_reference`  | Genera immagini utilizzando immagini di riferimento |
| `midjourney_describe`        | Genera descrizioni testuali in base alle immagini   |
| `midjourney_translate`       | Traduci suggerimenti in inglese                     |
| `midjourney_get_seed`        | Ottieni il valore seed dell'immagine                |
| `midjourney_generate_video`  | Genera video basati su immagini                     |
| `midjourney_extend_video`    | Estendi video esistenti                             |
| `midjourney_get_task`        | Consulta lo stato di un singolo compito             |
| `midjourney_get_tasks_batch` | Consulta lo stato di più compiti                    |

## Esempi di utilizzo

Dopo aver completato la configurazione, puoi chiamare direttamente queste funzionalità in linguaggio naturale nei client AI, ad esempio:

* "Aiutami a generare un'immagine di una città notturna in stile cyberpunk"
* "Cambia lo sfondo di questa immagine in una spiaggia"
* "Fondi queste quattro immagini in una sola"
* "Descrivi il contenuto di questa immagine"
* "Trasforma questa immagine in un video"
* "Ingrandisci il secondo variante di questa immagine"

## Maggiori informazioni

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