MCP Image MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Uma ferramenta: generate_image (abrange geração + edição)
Aprimoramento automático de prompt (Assunto · Contexto · Estilo)
Três níveis de qualidade: rápido, equilibrado e de qualidade
Resolução 4K; proporções de aspecto 1:1 a 21:9
Consistência de caracteres entre chamadas
Fundamentos da Pesquisa Google + conhecimento mundial

Demo ao vivo

Como fica na prática

mcp-image.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mcp-image": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-image"
      ],
      "env": {
        "GEMINI_API_KEY": "<from aistudio.google.com/apikey>",
        "IMAGE_OUTPUT_DIR": "/absolute/path/to/images"
      }
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "mcp-image": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-image"
      ],
      "env": {
        "GEMINI_API_KEY": "<from aistudio.google.com/apikey>",
        "IMAGE_OUTPUT_DIR": "/absolute/path/to/images"
      }
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "mcp-image": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-image"
      ],
      "env": {
        "GEMINI_API_KEY": "<from aistudio.google.com/apikey>",
        "IMAGE_OUTPUT_DIR": "/absolute/path/to/images"
      }
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-image": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-image"
      ],
      "env": {
        "GEMINI_API_KEY": "<from aistudio.google.com/apikey>",
        "IMAGE_OUTPUT_DIR": "/absolute/path/to/images"
      }
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "mcp-image",
      "command": "npx",
      "args": [
        "-y",
        "mcp-image"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "mcp-image": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-image"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add mcp-image -- npx -y mcp-image

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: MCP Image

Gere e repita uma imagem principal para uma página de destino

👤 Designers, fundadores, profissionais de marketing ⏱ ~15 min beginner

Quando usar: Você quer uma imagem de herói nova e não quer fazer malabarismos com 5 guias.

Pré-requisitos

Chave de API Gemini — https://aistudio.google.com/apikey
Diretório de saída — mkdir -p ~/imagens/mcp

Fluxo

Gerar v1

Gere uma imagem principal: espaço de trabalho mínimo, luz quente da hora dourada, 16:9, nível de qualidade, 2048px.✓ Copiado

→ Imagem salva em IMAGE_OUTPUT_DIR com prompt enriquecido ecoado de volta
Edite no local

Edite-o – adicione uma linha fina de árvores no horizonte, mantenha todo o resto.✓ Copiado

→ Variante salva; composição preservada
Experimente uma variante

A mesma cena, mas com tons mais frios, mantém o assunto idêntico.✓ Copiado

→ A consistência do personagem se mantém; mudança de cor

Resultado: Uma imagem de herói que pode ser entregue em minutos, não uma viagem de ida e volta com assento pago por Midjourney.

Armadilhas

Solicitando demais o otimizador — Deixe o aprimorador Subject-Context-Style fazer seu trabalho; pare de substituir com 5 linhas de adjetivos

Combine com: filesystem

Produza um conjunto de ilustrações consistentes com a marca

👤 Fundadores e designers individuais sem uma biblioteca de ativos de marca ⏱ ~45 min intermediate

Quando usar: Você precisa de 6 a 12 ilustrações que pareçam pertencer umas às outras.

Fluxo

Defina a folha de estilo

Gere uma referência de estilo: ilustração plana, paleta pastel suave, vinheta de 2 caracteres.✓ Copiado

→ A imagem inicial captura o estilo
Crie variações

Usando esse estilo, faça 6 ilustrações para nossas seções: onboarding, faturamento, equipe, integrações, segurança, análises.✓ Copiado

→ 6 imagens com estilo + personagens consistentes

Resultado: Um conjunto de ilustrações coeso sem contratar ilustrador por um dia.

Armadilhas

Deriva entre imagens — Sempre faça referência à imagem original e use 'manter estilo da semente'

Edite fotos de produtos com linguagem natural

👤 Operadores de comércio eletrônico, pequenas marcas ⏱ ~20 min beginner

Quando usar: Você tem uma foto bruta do produto e deseja o tratamento de herói sem Photoshop.

Fluxo

Carregar/referenciar a foto

Use product.jpg como base. Remova o fundo desordenado; mantenha a sombra; iluminação de estúdio.✓ Copiado

→ Foto de produto limpo com sombra natural
Adicionar contexto

O mesmo produto sobre uma superfície de mármore quente, de cima para baixo.✓ Copiado

→ Produto consistente com novo ambiente

Resultado: Imagens prontas para catálogo em minutos.

Combine com: filesystem

Combinações

Combine com outros MCPs para 10× de alavancagem

mcp-image + filesystem

Gere, liste, marque e organize uma biblioteca de imagens

Gere o conjunto de hoje em ~/images/mcp/2026-04-21/; em seguida, liste e renomeie por texto alternativo.✓ Copiado

mcp-image + magic-ui-mcp

Solte imagens de herói geradas em uma aterrissagem do Magic UI

Gere uma imagem principal e conecte-a ao componente principal do Magic UI.✓ Copiado

mcp-image + comfyui-mcp-server

Use imagem mcp para gerações únicas; ComfyUI para pipelines

Variantes rápidas via mcp-image; fluxo de trabalho de produção via ComfyUI.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
generate_image	prompt: str, tier?: fast\|balanced\|quality, aspect?: '1:1'\|'16:9'\|..., base_image?: path, size?: '1K'\|'2K'\|'4K'	Gere uma nova imagem ou edite uma existente com linguagem natural	1 Gemini image call

Custo e limites

O que custa rodar

Cota de API: Vinculado à cota de geração de imagens do seu plano Gemini API
Tokens por chamada: Insignificante para texto; bytes de imagem dominam
Monetário: Pagamento por imagem via API Gemini; nível gratuito disponível para desenvolvimento
Dica: Use tier=fast para iteração e tier=quality apenas para o detentor final.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: GEMINI_API_KEY apenas em env - nunca confirme. Gire do Google AI Studio se houver vazamento.

Saída de dados: Prompts e imagens base opcionais vão para a API Gemini do Google. Os bytes gerados retornam e são salvos localmente.

As políticas do Google se aplicam às imagens geradas. Não gere conteúdo que você não tem direitos para compartilhar.
As imagens base que você passa para edição são enviadas para o Gemini – trate-as como se você as tivesse postado na internet.

Solução de problemas

Erros comuns e correções

401/Chave API inválida

Confirme se GEMINI_API_KEY é a chave de API bruta do AI Studio (não o token OAuth) e se a geração de imagem está habilitada.

Verificar: curl https://generativelanguage.googleapis.com/v1beta/models?key=$GEMINI_API_KEY

Saídas salvas, mas vazias

IMAGE_OUTPUT_DIR pode não ser gravável ou estar ausente. Crie-o e tente novamente.

Verificar: touch $IMAGE_OUTPUT_DIR/.probe && rm $IMAGE_OUTPUT_DIR/.probe

O personagem muda entre gerações

Sempre passe a mesma base_image e inclua 'manter o assunto idêntico' no prompt.

Verificar: Diff two generations visually

Alternativas

MCP Image vs. outros

Alternativa	Quando usar	Troca
everart	Você tem modelos Everart treinados em estilo	Fornecedor diferente, cobertura de estilo diferente
comfyui-mcp-server	Você precisa de fluxos de trabalho SD/FLUX personalizados e controle total do pipeline	Configuração muito mais pesada
higgsfield-ai-prompt-skill	Você deseja ajuda imediata de engenharia para outro fornecedor	Somente prompts – sem inferência

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills