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ê.
npm view @expertintegrado/image-mcp readme e instale o servidor MCP de imagens da Expert Integrado para mim, seguindo o protocolo de onboarding assistido descrito lá: verifique os pré-requisitos, me pergunte com botões se eu quero que você faça as etapas de navegador por mim (criação das chaves de API), me avise dos custos por imagem, valide as chaves sem custo, registre o MCP e faça o teste final. Me peça o que precisar.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.