imagor-mcp è uno di quei progetti piccoli che risolvono un problema molto concreto per chi pubblica sul web ogni giorno: produrre decine o centinaia di immagini tutte uguali nello stile, diverse nei contenuti, senza impazzire con Photoshop, senza pagare un servizio esterno a ogni render e senza rinunciare alla velocità.
In sintesi, è un connettore open source tra un agente di intelligenza artificiale e imagor, un noto image server self-hosted. L'agente non disegna pixel a caso come un generatore creativo, ma compila una descrizione strutturata che diventa un URL imagor. Quell'URL, aperto da browser o CDN, restituisce l'immagine finale già ritagliata, ridimensionata, compressa e memorizzata in cache.
Per un founder, una PMI o un'agenzia italiana questo significa: open-graph per articoli e prodotti, card per e-commerce e cataloghi, coupon, volantini digitali, thumbnail e banner sempre coerenti con il brand, generabili in serie da un brief testuale e ospitabili su infrastruttura propria.
Cos'è imagor-mcp e cosa non è
imagor-mcp è un progetto pubblicato su GitHub come cshum/imagor-mcp, riportato con licenza MIT nei metadati. Come sempre per l'open source, prima di un uso commerciale è prudente verificare direttamente il file LICENSE nel repository clonato e la compatibilità con il proprio caso d'uso.
Il progetto si compone di due parti, secondo la documentazione dell'autore:
-
Un MCP server, cioè un server che parla Model Context Protocol, il protocollo aperto con cui gli assistenti AI e gli agenti di coding scoprono e invocano strumenti esterni in modo standard. Avviato in genere in modalità stdio sulla stessa macchina dell'agente, espone all'agente le capacità di template di imagor.
-
Una skill, cioè un pacchetto di istruzioni, esempi e schemi che insegnano all'agente come trasformare un brief del tipo "card 1200x630 con foto, titolo, prezzo e logo" in un layout valido che compila in un URL imagor.
È importante capire cosa non è. Non è un generatore di immagini AI alla Midjourney o Stable Diffusion, non inventa fotografie o illustrazioni e non sostituisce un designer per campagne creative una tantum. È un sistema di templating deterministico: a parità di input produce sempre lo stesso output, con font, colori, margini e loghi fissi. La creatività generativa produce meraviglia ma è imprevedibile e difficile da tenere on-brand; il templating produce ripetibilità, leggibilità e costi prevedibili.
Non è nemmeno un servizio SaaS ospitato. Sia imagor-mcp sia imagor vanno eseguiti da voi, in un container o su un vostro server. Questo è un vantaggio per sovranità dei dati e costi, ma richiede alguien che sappia gestire Docker, secret e cache.
Il contesto aiuta: imagor è un image server scritto in Go, molto usato come alternativa self-hosted a Cloudinary o Imgix per resize, crop, watermark, conversione di formato e crop intelligente on-demand tramite URL firmati. imagor-mcp aggiunge lo strato mancante, ovvero la possibilità di pilotarlo in linguaggio naturale tramite agenti.
A cosa serve: i casi d'uso che contano per PMI e agenzie
Per chi gestisce siti, shop, testate locali, ristoranti, hotel, studi professionali o cataloghi, il collo di bottiglia non è fare una bella grafica una volta, ma farne mille varianti sempre aggiornate.
Il primo caso è la social card e open-graph image. Quando condividete un articolo, una scheda prodotto o un evento su WhatsApp, Facebook, LinkedIn o X, l'anteprima è decisa dai meta tag og:image e twitter:image. Senza un'immagine 1200x630 dedicata, i social mostrano un ritaglio casuale o nessuna anteprima, con crollo del click-through. Con imagor-mcp l'agenzia può definire un template una volta — sfondo, font aziendale, logo, posizione del titolo — e poi generare automaticamente una card per ogni URL, con titolo e foto diversi ma impaginazione identica.
Il secondo caso è e-commerce e cataloghi. Card prodotto con prezzo, sconto, bollino, disponibilità, varianti per marketplace, comparatori e volantini. Se avete 500 referenze e cambiate i prezzi ogni settimana, rifare tutto a mano è insostenibile. Un template pilotato da dati produce le immagini al volo e le invalida solo quando cambiano i dati.
Il terzo caso è coupon, locandine e materiali locali. Offerte a tempo, menu del giorno, eventi, corsi, annunci immobiliari: tutti materiali con struttura fissa e testo variabile. Un operatore non grafico può chiedere all'agente "fai la locandina dell'aperitivo di venerdì con questa foto e questo prezzo" e ottenere l'URL pronto da stampare o pubblicare, senza aprire un software di grafica.
Il quarto caso è banner ADV e A/B test. Stesso messaggio, decine di formati: leaderboard, skyscraper, quadrato per feed, verticale per stories. Un sistema a template garantisce coerenza e permette di testare solo il testo o il colore del pulsante, senza ridisegnare tutto.
Il quinto caso, meno visibile ma prezioso per le agenzie, è l'automazione interna. Preventivi con copertina personalizzata, report mensili con grafici e intestazione cliente, certificati di partecipazione, badge per eventi. Tutto ciò che oggi è un file PowerPoint o Canva duplicato a mano diventa un URL generato da dati.
Il filo comune è: poche operazioni grafiche al giorno non giustificano questo strumento; centinaia di varianti al mese sì. Lì il risparmio di tempo e la coerenza ripagano l'installazione.
Come funziona: da brief in italiano a URL cacheabile
Il flusso tipico, come descritto dall'autore, si può riassumere in cinque passaggi.
1. Avete già imagor in esecuzione. Imagor è distribuito come container Docker, ad esempio shumc/imagor. In sviluppo si avvia in genere con una configurazione non sicura per fare prove veloci, mentre in produzione deve usare un SECRET per firmare gli URL con HMAC. La firma serve a impedire che chiunque possa chiedere al vostro server resize arbitrari e mandarlo in saturazione, il cosiddetto image bombing. Questo punto di sicurezza è fondamentale e va progettato prima di esporre il servizio.
2. Collegate l'agente a imagor-mcp. L'agente di coding o assistente — ad esempio un CLI agent in abbonamento — viene configurato per avviare imagor-mcp via stdio. A quel punto l'agente vede nuovi tool: elencare template disponibili, creare un nuovo template, compilare un layout in URL, verificare l'anteprima.
3. Scrivete il brief. Invece di calcolare voi crop e parametri, descrivete il risultato: dimensioni, immagine di base, testi, font, colori, logo, posizione. La skill guida l'agente a produrre un layout valido, con vincoli su leggibilità, contrasto e pesi dei file.
4. Compilazione in URL. Il layout non è un PNG, è una ricetta. imagor-mcp la traduce in un URL imagor del tipo /fit-in/1200x630/filters:format(jpeg):quality(80)/... eventualmente firmato. L'URL è lungo — l'autore cita come esempio un composito 1200x630 da 865 caratteri che restituisce un JPEG da circa 36 KB — ma è pensato per essere usato da macchine, non memorizzato a memoria.
5. Rendering e cache. Al primo accesso imagor scarica l'originale dallo storage configurato, applica le operazioni, ottimizza e restituisce il derivato. Da quel momento il risultato è cacheabile a più livelli: memoria interna, disco o S3, header HTTP per browser e CDN. Le visite successive non ricalcolano nulla, costano quasi zero e sono velocissime. L'autore dichiara una mediana di 119 millisecondi per quel composito di esempio; si tratta di una dichiarazione dell'autore non verificata in modo indipendente, utile come ordine di grandezza ma da misurare sul proprio hardware, con le proprie immagini e la propria rete.
Dal punto di vista tecnico, imagor supporta operazioni familiari a chi ha usato Thumbor o imgproxy: fit-in, smart-crop, fill, filtri per luminosità, blur, watermark, conversione in WebP o AVIF, qualità progressiva. La differenza è che non dovete imparare la sintassi: la scrive l'agente per voi, mentre voi controllate il risultato visivo.
Per uno sviluppatore italiano abituato a Next.js o PHP, il cambio di mentalità è questo: non salvate mille file JPG in una cartella public, salvate un template e generate gli URL a runtime dai dati del CMS o del gestionale. Se cambia il prezzo, cambia l'URL o si invalida la cache, non dovete rincorrere i file.
Perché conta: velocità, costi, brand e indipendenza
Il primo motivo è economico. I servizi di image CDN commerciali fatturano per trasformazioni, banda o posti. Per un blog o un piccolo shop i costi sono trascurabili, per un catalogo con decine di migliaia di immagini e traffico stagionale possono diventare una voce seria. Un server self-hosted sposta il costo su CPU e banda già pagate, prevedibile e senza conteggi per singola immagine. Il rovescio è che dovete gestirlo voi: aggiornamenti, monitoraggio, backup delle sorgenti.
Il secondo motivo è la velocità percepita. Un'immagine 1200x630 da 36 KB caricata da CDN vicina all'utente apre l'anteprima social e la pagina prodotto in un lampo, migliora Core Web Vitals, riduce il rimbalzo da mobile e aiuta il SEO indiretto. La leggerezza non è estetica, è fatturato per chi vende online.
Il terzo motivo è la coerenza di marca, spesso sottovalutata dalle PMI. Quando ogni commesso, stagista o fornitore fa grafiche diverse con font diversi, il brand si annacqua e sembra amatoriale. Un template blindato — font aziendali, palette, safe-area per loghi, contrasto minimo — garantisce che anche una card generata di fretta sia riconoscibile. L'agente può proporre testi, ma non può rompere la gabbia grafica se il template è ben fatto.
Il quarto motivo è l'indipendenza operativa. Rimanere su infrastruttura propria o su cloud europeo con container standard riduce il lock-in verso singoli fornitori USA e semplifica la conformità GDPR per foto di clienti o dipendenti, perché gli originali non lasciano il vostro storage. Non risolve da solo la conformità, ma evita di disseminare copie su servizi terzi.
Ci sono però limiti onesti da considerare. La qualità tipografica di un render automatico non eguaglia sempre quella di un designer per kerning, sillabazione italiana e gestione di testi lunghi. Le URL firmate vanno gestite con rotazione dei secret e scadenze, altrimenti rischiate abusi. L'integrazione con CMS particolari richiede sviluppo. E come per ogni progetto community, dovete valutare vitalità del repository, issue aperte, frequenza di release e se avete in casa le competenze Go, Docker e CDN per mantenerlo.
In sintesi, conta perché sposta la produzione di immagini seriali da lavoro manuale a infrastruttura: una volta disegnato bene il template, produrne mille costa quasi come produrne una.
Dove trovarlo, licenza e come provarlo senza rischi
Il codice è pubblicato su GitHub all'indirizzo github.com/cshum/imagor-mcp, con documentazione nel README e nella skill allegata. Il server imagor a cui si appoggia è il progetto separato imagor, anch'esso open source, con immagini Docker pubbliche. Cercate entrambi dai nomi esatti per evitare fork non ufficiali.
Sul piano della licenza, i metadati riportano MIT per imagor-mcp, una licenza permissiva molto usata e in genere adatta anche a usi commerciali. Attenzione però: il metadato non è il testo legale. Prima di integrarlo in prodotti per clienti, fate verificare da una persona competente il file LICENSE nel repository, le licenze delle dipendenze e quelle di imagor stesso, font e immagini di esempio che userete nei template.
Per una prova sicura, anche non sviluppatori possono chiedere al proprio tecnico un percorso in tre fasi. Prima in sandbox isolata, mai sul server di produzione e mai con foto reali di clienti: avvio di imagor in locale, collegamento di imagor-mcp all'agente, generazione di due o tre template di prova — ad esempio una open-graph 1200x630 e una card quadrata — con immagini e testi finti. Poi verifica visiva, peso in KB, tempo di risposta e header di cache. Solo dopo, disegno del template definitivo con il grafico, scelta di font con licenza web chiara, definizione dello storage degli originali e passaggio alla modalità con URL firmati per la produzione, dietro CDN.
Una checklist minima da portare in agenzia: volete template fissi o creatività libera? Quante varianti al mese? Dove risiedono gli originali? Chi firma gli URL e quanto durano? Come invalidate la cache quando cambia un prezzo? Come misurate peso e tempi reali? Se rispondete a queste domande, capirete in un pomeriggio se imagor-mcp è l'attrezzo giusto o se bastano gli strumenti che già usate.
Come sempre, le prestazioni e le funzioni descritte riflettono quanto dichiarato dall'autore al momento della rilevazione e vanno riverificate sulla versione che installerete, perché i progetti open source evolvono in fretta.