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

# Guia de Integração do Midjourney MCP

> midjourney MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) é um protocolo de contexto de modelo lançado pela Anthropic, que permite que modelos de IA (como Claude, GPT, etc.) chamem ferramentas externas através de interfaces padronizadas. Através do Midjourney MCP Server fornecido pela XHuoAPI, você pode gerar e editar imagens de IA diretamente em clientes de IA como Claude Desktop, VS Code, Cursor, entre outros.

## Visão Geral das Funcionalidades

O Midjourney MCP Server oferece as seguintes funcionalidades principais:

* **Geração de Imagens (Imagine)** — Gera imagens de alta qualidade a partir de prompts de texto
* **Edição de Imagens** — Realiza modificações locais em imagens já geradas
* **Transformação de Imagens** — Amplia, reduz ou move imagens existentes
* **Mistura de Imagens (Blend)** — Combina várias imagens em uma nova imagem
* **Geração de Imagens de Referência** — Usa imagens de referência para guiar a geração
* **Descrição de Imagens (Describe)** — Gera descrições textuais com base em imagens
* **Tradução de Prompts** — Traduz prompts em chinês para inglês
* **Obtenção de Sementes** — Obtém o valor de seed da imagem para reprodução
* **Geração de Vídeos** — Gera vídeos dinâmicos com base em imagens
* **Consulta de Tarefas** — Monitora o progresso da geração e obtém resultados

## Preparativos

Antes de usar, você precisa obter o Token da API da XHuoAPI:

1. Registre-se ou faça login na [plataforma XHuoAPI](https://api.xhuoapi.ai)
2. Vá para a página da [API Midjourney Imagine](https://api.xhuoapi.ai/documents/midjourney-imagine)
3. Clique em "Acquire" para obter o Token da API (o primeiro pedido oferece um crédito gratuito)

## Instalação e Configuração

### Método 1: Instalação via pip (recomendado)

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

### Método 2: Instalação a partir do código-fonte

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

Após a instalação, você pode usar o comando `mcp-midjourney` para iniciar o serviço.

## Usando no Claude Desktop

Edite o arquivo de configuração do Claude Desktop:

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

Adicione a seguinte configuração:

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

Se usar `uvx` (sem necessidade de instalar pacotes previamente):

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

Após salvar a configuração, reinicie o Claude Desktop para usar as ferramentas relacionadas ao Midjourney nas conversas.

## Usando no VS Code / Cursor

Crie um arquivo `.vscode/mcp.json` no diretório raiz do projeto:

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

Ou use `uvx`:

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

## Lista de Ferramentas Disponíveis

| Nome da Ferramenta           | Descrição                                    |
| ---------------------------- | -------------------------------------------- |
| `midjourney_imagine`         | Gera imagens a partir de prompts de texto    |
| `midjourney_edit`            | Edita áreas locais de imagens existentes     |
| `midjourney_transform`       | Amplia, reduz ou move imagens existentes     |
| `midjourney_blend`           | Mistura várias imagens em uma só             |
| `midjourney_with_reference`  | Gera imagens usando uma imagem de referência |
| `midjourney_describe`        | Gera descrições textuais com base em imagens |
| `midjourney_translate`       | Traduz prompts para inglês                   |
| `midjourney_get_seed`        | Obtém o valor de seed da imagem              |
| `midjourney_generate_video`  | Gera vídeos com base em imagens              |
| `midjourney_extend_video`    | Estende vídeos existentes                    |
| `midjourney_get_task`        | Consulta o status de uma única tarefa        |
| `midjourney_get_tasks_batch` | Consulta o status de várias tarefas          |

## Exemplos de Uso

Após a configuração, você pode chamar essas funcionalidades diretamente em linguagem natural em clientes de IA, por exemplo:

* "Ajude-me a gerar uma imagem de uma cidade à noite no estilo cyberpunk"
* "Mude o fundo desta imagem para a praia"
* "Misture estas quatro imagens em uma só"
* "Descreva o conteúdo desta imagem"
* "Transforme esta imagem em um vídeo"
* "Amplie a segunda variante desta imagem"

## Mais Informações

* Repositório no GitHub: [XHuoAPI/MidjourneyMCP](https://github.com/XHuoAPI/MidjourneyMCP)
* Pacote PyPI: [mcp-midjourney](https://pypi.org/project/mcp-midjourney/)
* Documentação da API: [API de Geração Midjourney](https://api.xhuoapi.ai/documents/midjourney)