MCP 服务器

MCP nano banana

Remote HTTP MCP server that generates LXP background images using Gemini 2.5 Flash Image, returning inline PNGs and public URLs with token-based authentication.

README

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).

Deploy no EasyPanel

Suba esta pasta num repositorio GitHub.
EasyPanel → Create App → GitHub → build por Dockerfile, porta 8080.
Volume persistente em /app/oauth-data (guarda a chave de assinatura).
Environment (veja .env.example): GEMINI_API_KEY, PUBLIC_BASE_URL, AUTH_PASSWORD, OAUTH_DATA_DIR=/app/oauth-data.
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.