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

# Guía de Integración de Midjourney MCP

> midjourney MCP 服务器集成

[MCP (Modelo Contexto Protocolo)](https://modelcontextprotocol.io) es un protocolo de contexto de modelo lanzado por Anthropic, que permite a los modelos de IA (como Claude, GPT, etc.) llamar a herramientas externas a través de interfaces estandarizadas. A través del Midjourney MCP Server proporcionado por XHuoAPI, puedes generar y editar imágenes de IA directamente en clientes de IA como Claude Desktop, VS Code, Cursor, etc.

## Resumen de Funciones

Midjourney MCP Server ofrece las siguientes funciones principales:

* **Generación de imágenes (Imagine)** — Generar imágenes de alta calidad a través de indicaciones de texto
* **Edición de imágenes** — Realizar modificaciones locales en imágenes ya generadas
* **Transformación de imágenes** — Ampliar, reducir y desplazar imágenes existentes
* **Mezcla de imágenes (Blend)** — Fusionar varias imágenes en una nueva imagen
* **Generación de imágenes de referencia** — Guiar la generación usando imágenes de referencia
* **Descripción de imágenes (Describe)** — Generar descripciones de texto basadas en imágenes
* **Traducción de indicaciones** — Traducir indicaciones en chino a inglés
* **Obtención de semillas** — Obtener el valor de seed de una imagen para reproducirla
* **Generación de videos** — Generar videos dinámicos basados en imágenes
* **Consulta de tareas** — Monitorear el progreso de generación y obtener resultados

## Preparativos Previos

Antes de usar, necesitas obtener el Token de API de XHuoAPI:

1. Regístrate o inicia sesión en [la plataforma XHuoAPI](https://api.xhuoapi.ai)
2. Ve a la página de [Midjourney Imagine API](https://api.xhuoapi.ai/documents/midjourney-imagine)
3. Haz clic en "Acquire" para obtener el Token de API (se ofrece un crédito gratuito en la primera solicitud)

## Instalación y Configuración

### Método 1: Instalación con pip (recomendado)

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

### Método 2: Instalación desde el código fuente

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

Una vez completada la instalación, puedes usar el comando `mcp-midjourney` para iniciar el servicio.

## Uso en Claude Desktop

Edita el archivo de configuración de Claude Desktop:

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

Agrega la siguiente configuración:

```json theme={null}
{
  "mcpServers": {
    "midjourney": {
      "command": "mcp-midjourney",
      "env": {
        "XHuoAPI_API_TOKEN": "tu Token de API"
      }
    }
  }
}
```

Si usas `uvx` (sin necesidad de instalar paquetes previamente):

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

Guarda la configuración y reinicia Claude Desktop para poder usar las herramientas relacionadas con Midjourney en la conversación.

## Uso en VS Code / Cursor

Crea un archivo `.vscode/mcp.json` en el directorio raíz del proyecto:

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

O usa `uvx`:

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

## Lista de Herramientas Disponibles

| Nombre de la herramienta     | Descripción                                        |
| ---------------------------- | -------------------------------------------------- |
| `midjourney_imagine`         | Generar imágenes a partir de indicaciones de texto |
| `midjourney_edit`            | Editar áreas locales de imágenes existentes        |
| `midjourney_transform`       | Ampliar, reducir y desplazar imágenes existentes   |
| `midjourney_blend`           | Mezclar varias imágenes en una sola                |
| `midjourney_with_reference`  | Generar imágenes usando imágenes de referencia     |
| `midjourney_describe`        | Generar descripciones de texto basadas en imágenes |
| `midjourney_translate`       | Traducir indicaciones a inglés                     |
| `midjourney_get_seed`        | Obtener el valor de seed de una imagen             |
| `midjourney_generate_video`  | Generar videos basados en imágenes                 |
| `midjourney_extend_video`    | Extender videos existentes                         |
| `midjourney_get_task`        | Consultar el estado de una tarea individual        |
| `midjourney_get_tasks_batch` | Consultar el estado de tareas en lote              |

## Ejemplos de Uso

Una vez configurado, puedes llamar a estas funciones directamente en el cliente de IA usando lenguaje natural, por ejemplo:

* "Ayúdame a generar una imagen de una ciudad nocturna en estilo ciberpunk"
* "Cambia el fondo de esta imagen a la playa"
* "Mezcla estas cuatro imágenes en una"
* "Describe el contenido de esta imagen"
* "Convierte esta imagen en un video"
* "Amplía la segunda variante de esta imagen"

## Más Información

* Repositorio de GitHub: [XHuoAPI/MidjourneyMCP](https://github.com/XHuoAPI/MidjourneyMCP)
* Paquete de PyPI: [mcp-midjourney](https://pypi.org/project/mcp-midjourney/)
* Documentación de API: [API de generación de Midjourney](https://api.xhuoapi.ai/documents/midjourney)