Geração e edição de imagens dentro do Claude Code: você pede em português, o servidor fala com o GPT Image (OpenAI) ou o Nano Banana (Google) e a imagem pronta aparece na sua pasta de Imagens.
Um servidor MCP local que dá ao Claude Code o poder de criar, editar e preparar imagens — feito para quem não programa.
"Gere uma imagem de um escritório moderno, 16:9" — é só isso. O resultado cai pronto na pasta Imagens/image-mcp.
GPT Image 2 (OpenAI) para composições complexas e texto na imagem; Nano Banana (Google) para volume rápido e barato — escolha por pedido.
Parta de fotos existentes: troque o fundo, combine elementos de várias imagens, gere variações de produto — com máscara opcional nos modelos OpenAI.
Converter formato, redimensionar, comprimir e gerar link público da imagem — tudo local ou em serviço gratuito, sem gastar um centavo de API.
O servidor roda na sua máquina (via npx, sem instalar nada manualmente) e fala direto com o provedor usando a sua chave — sem intermediário.
"Gere uma imagem de produto de uma caneca azul, fundo branco". Se você não disser o formato, o Claude pergunta antes — oferecendo os padrões de mercado (1:1, 9:16, 16:9…).
generate_image para criar do zero; edit_image sempre que existe imagem de partida — referência, combinação de fotos ou máscara marcando a região a alterar.
A requisição vai direto da sua máquina para a API da OpenAI ou do Google (conforme o modelo pedido). A chave fica só na configuração local do Claude Code — nunca passa por servidor de terceiros.
O resultado chega em base64 e é salvo como PNG na pasta Imagens/image-mcp (configurável via IMAGE_MCP_OUTPUT_DIR), com nome datado e descritivo.
Converter/redimensionar/comprimir localmente (convert_image) e, quando a plataforma pede o link da imagem, hospedar de graça com host_image — permanente ou expirando sozinho em 1h–72h.
Só a geração e a edição consomem créditos do provedor — o resto roda local na sua máquina ou em serviço gratuito.
Cria imagem(ns) a partir de um texto, em qualquer um dos 6 modelos registrados, e salva em disco. Até 4 por pedido.
usa API do provedorEdita ou gera a partir de imagens de referência: troca de fundo, combinação de fotos, variações. Máscara (região exata) nos modelos OpenAI.
usa API do provedorConverte png/jpeg/webp/avif, redimensiona e comprime — processamento local com sharp, instantâneo.
grátis · localDimensões, formato, peso em disco e transparência de qualquer imagem local — útil antes de editar ou publicar.
grátis · localSobe a imagem para hospedagem gratuita e devolve a URL pública — permanente ou temporária (1h a 72h). Sem cadastro, sem chave.
grátis · sem cadastroLista os modelos disponíveis no servidor e o que cada um suporta (edição, padrão).
grátis · localO Image MCP é gratuito e de código aberto. As imagens geradas consomem créditos da sua chave de API — na OpenAI ou no Google.
OpenAI cobra por imagem (varia com qualidade e tamanho) e exige créditos pré-pagos. O Google tem nível gratuito limitado — dá para começar sem pagar nada — e depois cobra por imagem. As ferramentas locais (convert_image, get_image_info) e o link público (host_image) não custam nada. Durante a instalação guiada, o Claude avisa esses custos antes de concluir.
| Modelo | Provedor | Melhor para | Custo aprox./imagem* |
|---|---|---|---|
| gpt-image-2 (padrão) | OpenAI | Composições complexas, texto dentro da imagem | US$ 0,01–0,25 |
| gemini-3.1-flash-image · Nano Banana 2 | Rápido e barato, ótimo para volume | US$ 0,03–0,06 | |
| gemini-3-pro-image · Nano Banana Pro | Máxima qualidade e controle criativo | a partir de US$ 0,06 |
*Valores aproximados — confira as tabelas oficiais de preço da OpenAI e do Google. Também disponíveis: gpt-image-1, gpt-image-1-mini e gemini-2.5-flash-image (legado).
Não precisa saber programar nem baixar nada: o pacote roda direto do npm via npx.
Instalado e funcionando (claude.com/claude-code).
Baixe em nodejs.org e clique em avançar até concluir. Precisa ser versão 20 ou superior.
Google (Nano Banana, tem nível gratuito) e/ou OpenAI (GPT Image, pago). O Claude oferece te guiar na criação — inclusive abrindo o navegador por você.
Criar a chave no painel do provedor é no navegador — o Claude pergunta se você quer que ele faça por você (via Playwright MCP ou Claude in Chrome) ou prefere o passo a passo manual. O login é sempre você quem faz.
Antes de concluir, o Claude confere cada chave num endpoint gratuito do provedor (lista de modelos) — sem gerar imagem, sem gastar crédito.
A chave entra direto na configuração local do Claude Code — nunca em repositório, chat público ou log. Trate chave de API como senha de banco.
No fim, o Claude pede para reiniciar o Claude Code e gera uma imagem de teste — avisando antes que ela já consome crédito (ou o nível gratuito do Google).
Um único server.js, sem SDK de provedor — só fetch nativo. Fácil de auditar, fácil de estender com um provedor novo.