Guia de Integração do Midjourney MCP

MCP (Model Context Protocol) é 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:

Registre-se ou faça login na plataforma XHuoAPI
Vá para a página da API Midjourney Imagine
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)

pip install mcp-midjourney

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

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:

{
  "mcpServers": {
    "midjourney": {
      "command": "mcp-midjourney",
      "env": {
        "XHuoAPI_API_TOKEN": "seu Token da API"
      }
    }
  }
}

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

{
  "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:

{
  "servers": {
    "midjourney": {
      "command": "mcp-midjourney",
      "env": {
        "XHuoAPI_API_TOKEN": "seu Token da API"
      }
    }
  }
}

Ou use uvx:

{
  "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
Pacote PyPI: mcp-midjourney
Documentação da API: API de Geração Midjourney

Documentation Index

​Visão Geral das Funcionalidades

​Preparativos

​Instalação e Configuração

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

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

​Usando no Claude Desktop

​Usando no VS Code / Cursor

​Lista de Ferramentas Disponíveis

​Exemplos de Uso

​Mais Informações