Skip to main content
Glama

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

Parametro

Valores

Uso

prompt

texto (ingles rende melhor)

o que gerar

proporcao

1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 4:5, 5:4, 21:9, 9:21

forma da imagem

largura / altura

px (64-4096)

dimensao exata (ignora proporcao)

estilo

texto livre

ex.: fotografico, ilustracao flat, 3d, minimalista

evitar_texto

true/false

forca sem texto/logo (util p/ fundos)

ajuste

cover / contain / fill

como encaixar na dimensao final

fundo

hex (ex.: #FFFFFF)

cor de fundo quando ajuste=contain

formato

png / jpeg / webp

formato de saida

nome_arquivo

texto

nome do arquivo (opcional)

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.

Related MCP Connectors

Related MCP Servers