🎨 Image MCP — gere e edite imagens dentro do Claude Code

Este projeto conecta o Claude Code aos melhores modelos de geração de imagem do mercado — GPT Image 2 (OpenAI) e Nano Banana (Google). Depois de instalar, você simplesmente conversa: "gere uma imagem de...", "edite essa foto e troque o fundo..." — e as imagens aparecem na sua pasta Imagens/image-mcp.

Não precisa saber programar. A instalação é o Claude quem faz.

O que você precisa antes

1. Claude Code instalado (claude.com/claude-code)

2. Node.js (versão LTS): baixe em nodejs.org, clique em avançar até concluir

3. Pelo menos uma chave de API — veja "Como criar as chaves" abaixo (a do Google tem nível gratuito)

Related MCP server: mcp-openai-images-audio

Instalação (1 passo — nem precisa baixar nada)

Abra o Claude Code em qualquer pasta, cole este prompt e aperte Enter:

Leia https://raw.githubusercontent.com/Expert-Integrado/image-mcp/main/SETUP.md e siga as instruções para instalar o MCP de imagens da Expert para mim. Me peça o que precisar.

O Claude instala tudo, pede suas chaves e configura sozinho. No final, feche e reabra o Claude Code e teste: "gere uma imagem de teste de um abacaxi de óculos escuros". As imagens geradas ficam na sua pasta Imagens/image-mcp.

Como criar as chaves

Google — Nano Banana (tem nível gratuito, comece por aqui)

1. Acesse aistudio.google.com/apikey e entre com sua conta Google.

2. Clique em Create API key (Criar chave de API).

3. Copie a chave (começa com AIza) e guarde num lugar seguro.

OpenAI — GPT Image (pago, precisa de créditos)

1. Crie conta / faça login em platform.openai.com.

2. Em Settings → Billing, adicione créditos (US$ 5 já rende muitas imagens).

3. Em platform.openai.com/api-keys, clique em Create new secret key e copie a chave (começa com sk-).

⚠️ Chave de API é como senha de banco: não compartilhe, não poste em grupo, não mande print.

Como usar (exemplos de pedidos)

• "Gere uma imagem de um escritório moderno minimalista, formato 16:9"

• "Gere com o Nano Banana uma foto de produto de uma caneca azul em fundo branco"

• "Edite a foto do produto que está em Imagens/image-mcp: troque o fundo por uma praia ao pôr do sol"

• "Converta essa imagem para webp" / "diminui essa imagem para 800px" (grátis, sem API)

• "Quais modelos de imagem estão disponíveis?"

Formatos de imagem (padrões de mercado)

Se você não disser o formato, o Claude vai perguntar. Estes são os padrões disponíveis:

Exemplo: "gere em 9:16 uma arte de stories anunciando nossa mentoria".

Modelos disponíveis e custo aproximado

*Valores aproximados — confira as tabelas oficiais de preço da OpenAI e do Google.

Para quem é técnico

• Instalação direta: claude mcp add --scope user -e OPENAI_API_KEY=... image-mcp -- npx -y @expertintegrado/image-mcp

• Ferramentas MCP: generate_image, edit_image (múltiplas referências + máscara nos modelos OpenAI), convert_image (formato/resize/compressão local via sharp, sem API), get_image_info, list_image_models.

• Envs: OPENAI_API_KEY, GEMINI_API_KEY (pelo menos uma), IMAGE_MCP_OUTPUT_DIR (opcional, padrão ~/Pictures/image-mcp).

• Teste: clone o repo e rode npm install && npm test (smoke test via stdio, não gasta API).

• Adicionar provedor/modelo: em server.js, crie um objeto com generate()/edit() retornando array de base64, registre em PROVIDERS e adicione os modelos em MODELS. Sem SDKs de provedor — só fetch nativo.

• Hospedar online (futuro): trocar StdioServerTransport por Streamable HTTP; em Cloudflare Workers, usar o template de MCP da plataforma e mover as chaves para secrets.