mcp-carousel-engine
The server exposes 4 MCP tools for designing and rendering 4:5 vertical social carousels (1080x1350 PNG + HTML preview).
get_design_rules — returns mandatory design rules: 4:5 vertical ratio (1080x1350), zero-emoji policy, and typography standards.
list_creative_archetypes — returns a catalogue of creative layout archetypes (Dark Neo-Geometric, Frosted Glass Blueprints, Minimal Luxury Monolith) with color palettes and layout suggestions.
list_design_primitives — lists available React design primitives (SlideCanvas, WireframeGrid, ShadedOrb3D, LayeredCard, PillBadge, GradientMaskText, ProfileMedal, CarouselDots) with their props.
render_carousel_project — renders a complete 5–7 slide carousel into lossless 1080x1350 PNGs plus an interactive HTML preview, taking
outputDirectory,topic,author(name/title/handle/avatarPath),slides(cover/card/signature with title1, title2, pillTag, description, bulletPoints), andthemeColor.Caveats: the schema conflicts with the README — it exposes only 4 of the 6 documented tools (no
list_theme_presetsormatch_design_dna), enforces 5–7 slides instead of 2–10, references React primitives despite React being purged, omits PDF export, and lists different archetype names than the README's four.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-carousel-engine create a 6-slide carousel explaining microservices architecture"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Carousel Engine v4.0

The Sovereign Multi-Archetype Model Context Protocol (MCP) Server for High-End 4:5 Vertical Social Carousels.
Designed and engineered by Said KOMI (Ingénieur Réseaux et Système).
Aperçu Visuel • Nouveautés v4.0 • Les 4 Archétypes • Presets Métiers • Micro-Charts SVG • Patterns de Slides • Outils MCP • Intégration Agensi.io
[▸] Quoi de neuf dans la Version 4.0 ?
Sécurité Entreprise & Neutralisation Anti-XSS :
Sanitisation systématique et whitelisting strict de toutes les interpolations HTML utilisateur et LLM.
Éradication des risques d'injection DOM dans Chromium (
--no-sandbox) : les balises malveillantes (<script>,<iframe>,onload=, etc.) sont neutralisées en entités HTML.Préservation ciblée des balises sémantiques et de style autorisées (
<span class="accent">,<code>,<mark>,<strong>,<em>,<br>).
Validation d'Entrée Stricte par Schéma Zod :
Validation typée Zod (
CarouselProjectSchema,SlideInputSchema) en amont de toute exécution.Contraintes strictes sur la pagination : 2 à 10 slides par carrousel (optimisé pour LinkedIn 5 à 7 slides).
Sanitisation des répertoires d'export (
outputDirectory) contre les attaques par traversée de chemin (Path Traversal).
Portabilité Multi-OS & Détection Dynamique des Navigateurs :
Détection intelligente de Google Chrome, Microsoft Edge et Brave sur Windows, macOS et Linux.
Fallback automatique transparent sur le Chromium géré par Puppeteer.
Avatar Vectoriel Procédural SVG Dynamique :
Découplage complet des chemins de fichiers locaux en dur.
Si aucun avatar photo n'est spécifié, le moteur synthétise automatiquement un avatar SVG vectoriel haute définition avec monogramme d'autorité et halo néon calibré selon la palette active.
Déblocage Intégral des 4 Archétypes de Design :
Tous les archétypes sont désormais pleinement opérationnels et testés à 100% :
swiss-editorial-clean(Minimalisme suisse, Klein Blue, typographie 900 asymétrique).cyber-glass-bento(Glassmorphism cyber-sécurité, bordures laser cyan, compartiments floutés).paper-light-editorial(Presse économique, papier ivoire chaud, liseré bordeaux).neo-geometric-dark(La Formule Souveraine originale, fond noir absolu, orbes 3D et carte blanche).
Tag Matcher sémantique corrigé avec détection par mot entier (
word boundary) gérant les accents français.
Architecture Allégée & Zéro Code Mort :
Purge complète de
react,react-dometremotionsuperflus.Restauration des sources documentaires TypeScript (
src/documents/) pour une compilation TypeScript 100% autonome et déterministe.
Packaging Commercial Agensi.io & Claude Code :
Module agentique prêt à l'emploi dans
skills/linkedin-carousel-pro/avec fichier de compétenceSKILL.md, prompts orchestrateurs et exemples JSON réels.
Related MCP server: MotionDesign MCP
[▸] Les 4 Archétypes de Design
Archétype | ADN Visuel | Cas d'Usage Idéaux |
| Fond noir absolu | Architecture Cloud, Systèmes Distribués, Santé Digitale. |
| Fond papier ivoire chaud | Rapports Annuels, Conjoncture, Intelligence Économique, Mémos. |
| Fond papier ivoire chaud | Fintech, Core Banking, Mémos Stratégiques, Leadership. |
| Fond nuit cyber | Cybersécurité, SOC, Télémétrie, Zero-Trust, Protocoles Réseau. |
[▸] Presets de Thèmes Métiers
Preset | Industrie / Spécialité | Couleurs d'accent | Usage recommandé |
| Cloud, Infra, SRE | Orange AWS ( | AWS, Kubernetes, Terraform, VPC, Scalabilité |
| Sécurité, SOC, Pentest | Vert Matrice ( | Zero-Trust, mTLS, Audit, SIEM, ISO 27001 |
| Finance & Micro-latence | Bleu Klein ( | Passerelles de paiement, P99, Kafka, Consensus |
| IA, LLM & MLOps | Violet Quantique ( | Transformers, GPU H100, Inférence, RAG, Fine-tuning |
| Pure Architecture & Craft | Encre Noire ( | Clean Architecture, Refactoring, Manifestes |
(Le moteur sélectionne automatiquement le preset le plus adapté par analyse sémantique si le champ est omis).
[▸] Micro-Graphiques Vectoriels SVG Mathématiques
Chaque slide de type metric-chart peut accueillir un visualiseur vectoriel natif calculé géométriquement :
area-sparkline: Courbe de Bézier cubique Catmull-Rom avec ligne de seuil SLA, points d'inflexion et dégradé d'aire remplie.bento-bars: Barres horizontales de benchmark avec badge d'accentuation, métrique delta et étiquettes comparatives.radial-gauge: Jauge circulaire à arc paramétrique (260°), score central et sous-titre de certification.pipeline-flow: Topologie de flux horizontal reliant des nœuds de microservices avec tags de protocole et latences associées.
[▸] Les Patterns de Mise en Page
Pattern | Rôle Visuel | Champs Déclencheurs |
| Métrique monumentale au centre avec adaptation typographique anti-débordement. |
|
| Comparaison split 2 colonnes : Mauvaise pratique vs Standard recommandé. |
|
| Étapes séquentielles numérotées reliées par connecteur vertical. |
|
| Terminal développeur avec en-tête macOS et code pré-formaté. |
|
| Citation d'autorité avec grand guillemet esthétique et signature auteur. |
|
| Carte maîtresse avec titre bicolore bold/thin, description et tirets d'accent. |
|
[▸] Les 5 Règles d'Or du Système
N° | Règle | Spécification Technique | Rationale |
01 | Ratio 4:5 Vertical Strict | Canvas fixé à $1080\text{ px} \times 1350\text{ px}$ avec | Format d'engagement maximal sur LinkedIn mobile & desktop. |
02 | Zéro Émoji (Strict Policy) | Interdiction totale des émojis. Glyphes autorisés : | Esthétique d'ingénierie moderne, sobre et hautement crédible. |
03 | Éclairage & Contraste Harmonique | Halos diffus, sphères 3D ou bordures de verre selon l'archétype sélectionné. | Profondeur et finitions de niveau agence de design. |
04 | Avatar Vectoriel ou Cadrage Précis | Avatar vectoriel SVG automatique ou photo utilisateur cadrée sans distorsion. | L'identité de l'auteur n'est jamais déformée ni tronquée. |
05 | Rendu Headless Chromium Autonome | Capture native via Chromium Headless à échelle 2x Retina + PDF LinkedIn. | Images PNG d'une netteté cristalline et PDF multipages prêts à poster. |
[▸] Installation & Configuration
Option A : Exécution Directe (NPX)
{
"mcpServers": {
"carousel-engine": {
"command": "npx",
"args": ["-y", "mcp-carousel-engine"]
}
}
}Option B : Installation Locale depuis les sources
git clone https://github.com/saidkomi/mcp-carousel-engine.git
cd mcp-carousel-engine
npm install
npm run buildConfiguration locale du client MCP :
{
"mcpServers": {
"carousel-engine": {
"command": "node",
"args": ["c:/VEILLE TECHNOLOGIQUE/laboratoires/agentic-google/mcp-carousel-engine/dist/index.js"]
}
}
}[▸] Outils MCP Exposés
1. render_carousel_project
Compile le projet complet (slides vectorielles, micro-graphiques mathématiques SVG, orbes 3D), pilote Chromium Headless en tâche de fond, génère les PNGs $1080 \times 1350$ Retina 2x, assemble le PDF multipages natif LinkedIn (linkedin_carousel.pdf) et crée la galerie interactive index.html.
2. list_theme_presets
Retourne les 5 presets métiers calibrés (cloud-devops, cybersecurity, fintech-systems, ai-deeptech, monochrome-swiss) et les spécifications des 3 modes visuels (hybrid, dark, light).
3. get_design_rules
Retourne les règles typographiques, la Formule Souveraine Hybride, le ratio strict (1080x1350) et la politique zéro-émoji.
4. list_creative_archetypes
Catalogue des 4 archétypes de mise en page avec recommandations de palettes et structures.
5. match_design_dna
Prend { topic, industry, tone } et déduit automatiquement le profil de Design DNA le plus adapté (palette, grille, tokens, archétype).
6. list_design_primitives
Liste les primitives de mise en page réutilisables HTML/CSS/SVG (grilles 4:5, sphères 3D, pilules néon, conteneurs bento, cartes monumentales).
[▸] Packaging Commercial Agensi.io
Le serveur est livré avec son package de compétence certifié :
Répertoire :
skills/linkedin-carousel-pro/Spécification :
SKILL.md(compatible Agensi.io, Claude Code, Cursor, Copilot)Exemples complets :
skills/linkedin-carousel-pro/examples/cloud-architecture.jsonskills/linkedin-carousel-pro/examples/cybersecurity-audit.jsonskills/linkedin-carousel-pro/examples/fintech-executive.json
Prompt orchestrateur :
skills/linkedin-carousel-pro/prompts/orchestrator.md
[▸] Auteur & Licence
Concepteur & Architecte : Said KOMI
Rôle : Ingénieur Réseaux et Système
Licence : Propriétaire — Tous droits réservés (voir LICENSE)
Toute reproduction, distribution ou exploitation commerciale non autorisée est strictement interdite.
Available Tools
4 toolsget_design_rulesA
Returns the mandatory design rules, aspect ratios (4:5 vertical 1080x1350), zero-emoji policy, and typography standards for creating world-class carousels.
Inputs: no named parameters.
list_creative_archetypesA
Returns a catalogue of creative layout archetypes (Dark Neo-Geometric, Frosted Glass Blueprints, Minimal Luxury Monolith) with color palettes and layout suggestions.
Inputs: no named parameters.
list_design_primitivesA
Lists all available React design primitives (SlideCanvas, WireframeGrid, ShadedOrb3D, LayeredCard, PillBadge, GradientMaskText, ProfileMedal, CarouselDots) with their props.
Inputs: no named parameters.
render_carousel_projectA
Renders a complete 5 to 7 slide carousel into lossless 1080x1350 PNG images and creates an interactive HTML preview.
Inputs: topic (required), author (required), slides (required), outputDirectory (required), +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct role: retrieving design rules, listing archetypes, listing primitives, and rendering the final project. There is no overlap between any of the four purposes, so an agent cannot easily misselect.
All names follow a consistent verb_noun snake_case pattern (get_design_rules, list_creative_archetypes, list_design_primitives, render_carousel_project). The convention is predictable throughout.
Four tools is on the lean side but coherent for a focused carousel generator: three are read-only reference lookups and one produces output. It is well-scoped, though slightly thin for a full authoring pipeline.
The surface covers the key lifecycle of discovery (rules, archetypes, primitives) plus final rendering, with no obvious dead ends. Minor gaps like validation, single-slide preview, or export-format options exist but are workable.
Maintenance
Related MCP Connectors
On-brand ad creative generation: teach it your brand once, generate images and video forever.
Live React design-system APIs, patterns, and code validation so AI agents build real UI, not slop.
Build and run visual creative-production workflows from your AI agent.
Deterministic visual marketing engine. Your agent plans, renders, and posts on-brand campaigns.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI clients to generate premium 4K carousel slides from a single instruction, combining expert copywriting, AI image generation, and premium typography compositing.-
- AlicenseAqualityCmaintenanceEnables AI assistants to architect and build Awwwards-level websites with spring physics, design systems, React 19 templates, and HD visual inspection.10MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI coding assistants to generate bespoke design systems by synthesizing OKLCH color palettes, chamfer highlights and spring physics, teaching layout composition grammar, and returning micro-interaction primitives and component blueprints. Also audits JSX/TSX/HTML through a senior design director's lens to score and critique UI quality.1 npm1MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI coding agents to act like a senior UI/UX team by reading an existing site's design DNA and tokens, proposing distinct art directions and motion mechanics that fit the brief, and validating changes in a live headless Chromium browser. Provides per-element accessibility and performance auditing (WCAG 2.2 contrast, focus, clipping, phone-menu behavior, LCP/CLS) at multiple viewport widths, plus baseline capture, before/after comparison, and one-command rollback for safe redesigns.77 npm3MIT