Cowork Image MCP — gerador de imagens generico (HTTP Streamable + OAuth 2.1)

Servidor MCP remoto para gerar imagens em qualquer proporcao/uso (site/hero, landing page, post social, story, thumbnail, banner, fundo, etc.) com o Gemini 2.5 Flash Image. Roda no EasyPanel e conecta no Claude / Cowork com OAuth 2.1 integrado no proprio projeto (sem provedor externo).

Mesma base tecnica do projeto da LXP (HTTP Streamable + OAuth self-hosted), porem a ferramenta e generalista: voce controla proporcao, dimensao, estilo, ajuste e formato.

Ferramenta: gerar_imagem

Devolve a imagem inline + uma URL publica (/files/...).

Guia rapido de proporcao por uso

• 16:9 hero de site / capa de video · 21:9 banner largo

• 1:1 post social · 4:5 feed vertical · 9:16 story / reels

• 3:2 / 2:3 landing page / cartaz · 4:3 / 3:4 cards

• ou informe largura+altura exatas (ex.: 1920x1080, 1080x1350).

Related MCP server: nano-banana-mcp

Deploy no EasyPanel

1. Suba esta pasta num repositorio GitHub.

2. EasyPanel → Create App → GitHub → build por Dockerfile, porta 8080.

3. Volume persistente em /app/oauth-data (guarda a chave de assinatura).

4. Environment (veja .env.example): GEMINI_API_KEY, PUBLIC_BASE_URL, AUTH_PASSWORD, OAUTH_DATA_DIR=/app/oauth-data.

5. Deploy. Teste: curl https://SEU_DOMINIO/health.

Conectar no Claude / Cowork

Conector personalizado → URL https://SEU_DOMINIO/mcp → autenticacao OAuth. O Claude faz DCR + PKCE sozinho e abre a sua tela de senha (AUTH_PASSWORD).

Seguranca

• AUTH_PASSWORD e o elo principal — use algo forte.

• Chave de assinatura (RS256) em OAUTH_DATA_DIR — mantenha o volume, nao commite.

• Codes single-use (60s), PKCE S256 obrigatorio. Geracao roda na SUA chave/billing.