mcp-carousel-engine
This server generates professional 4:5 vertical social carousels (1080x1350) for LinkedIn and other platforms, using automated headless Chromium rendering and design presets.
Render complete carousel projects into lossless Retina 2x PNG images and an interactive HTML preview.
Automatically compile a multipage LinkedIn PDF (
linkedin_carousel.pdf) for each carousel.Choose from 5 industry theme presets:
cloud-devops,cybersecurity,fintech-systems,ai-deeptech, andmonochrome-swiss.Use 3 visual modes:
hybrid,dark, andlight.Apply 4 creative archetypes such as neo-geometric dark, paper-light editorial, swiss editorial, and cyber-glass bento.
Leverage 6 layout patterns: stat-highlight, comparison-versus, flow-pipeline, code-terminal, manifesto-quote, and classic-card.
Include vector SVG micro-charts: area-sparkline, bento-bars, radial-gauge, and pipeline-flow.
Query design rules, creative archetypes, design primitives, and theme presets via MCP tools.
Match a topic/industry/tone to a recommended design DNA with
match_design_dna.Supports optional Pro license key to remove watermarks and enable white-label branding.
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-enginecreate 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 v3.3
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 • Presets de Thèmes • Modes Visuels • Micro-Charts Vectoriels • Les Patterns de Mise en Page • Installation • Outils MCP
[▸] Quoi de neuf dans la Version 3.3 ?
3 Modes Visuels (
themeMode) :hybrid(Signature Said KOMI) : Fond noir absolu#000000+ Carte flottante blanche#FFFFFF+ Sphères 3D + Badges néon.dark(Full Dark Terminal) : Fond noir#000000+ Carte centrale graphite#111113+ Typographie blanche pure & zinc#A1A1AA+ Accents luminescents.light(Paper Light Editorial) : Toile ivoire chaude#F6F5F0+ Carte centrale blanche#FFFFFF+ Typographie encre sombre#0A0A0A.
5 Presets de Thèmes Métiers & Détection Automatique Intelligente (
preset) :cloud-devops: Orange AWS (#FF9900) & Émeraude (#10B981) — Standard d'autorité pour Cloud Architects & Leads DevOps.cybersecurity: Vert Matrice Terminal (#10B981) & Cyan Laser (#00F0FF) — Dédié aux RSSI, pentesters et analystes SOC.fintech-systems: Bleu International Klein (#0052FF) & Cyan Électrique (#06B6D4) — Systèmes transactionnels, Core Banking et APIs haute vélocité.ai-deeptech: Violet Quantique (#8B5CF6) & Cyan Cyber (#06B6D4) — LLMs, RAG, inférence et architectures d'IA.monochrome-swiss: Encre Pure (#0A0A0A) & Zinc Architectural (#71717A) — Minimalisme brutaliste, code craftsmanship et manifestes. (Inférence automatique par analyse pondérée des mots-clés du sujet si le preset est omis !)
Micro-Graphiques Vectoriels Purs SVG Mathématiques (
chart) :area-sparkline(Courbe de Bézier cubique Catmull-Rom avec ligne de seuil SLA et aire remplie)bento-bars(Barres horizontales de benchmark contrastées avec badges delta et mise en valeur)radial-gauge(Jauge circulaire de jauge/score avec grand pourcentage central et sous-titre)pipeline-flow(Topologie de nœuds horizontaux avec badges de latence et connecteurs vectoriels)
Export PDF LinkedIn Natif Multipages : Compilation automatique d'un fichier
linkedin_carousel.pdfoptimisé au ratio 1080x1350 à chaque génération.
Related MCP server: CodeCrafted Design 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. |
[▸] Les 6 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 mobile (LinkedIn, Instagram, Facebook). |
02 | Zéro Émoji (Strict Policy) | Interdiction totale des émojis. Utilisation exclusive de glyphes ( | Confère un look d'ingénierie moderne, sobre et hautement professionnel. |
03 | Éclairage 3D & Contraste Harmonique | Dégradés radiaux multi-points avec halos diffus ou verre dépoli spatial. | Crée une illusion de profondeur tridimensionnelle sans moteur 3D lourd. |
04 | Cadrage Zéro Coupure de l'Avatar | Ancrage optique calibré ( | Garantit que le visage et les cheveux de l'auteur ne sont jamais tronqués. |
05 | Rendu Headless Chromium Autonome | Capture native via Chromium Headless à échelle 2x Retina. | Fichiers PNG vectoriels d'une netteté cristalline, 100% automatisés. |
[▸] Modèle Freemium & Licence Pro
Ce serveur MCP adopte une architecture Freemium Virale & White-Label Pro :
Fonctionnalité | Version Gratuite (Community) | Version Pro (White-Label) |
Accès aux 5 Presets Métiers | ✓ Inclus | ✓ Inclus |
Micro-Graphiques Vectoriels SVG | ✓ Inclus | ✓ Inclus |
Export PNG 2x Retina & PDF LinkedIn | ✓ Inclus | ✓ Inclus |
Watermark discret d'attribution |
| Zéro Watermark (100% White-Label) |
Branding Entreprise Personnalisé | Standard | Accès prioritaire & Logos custom |
Obtention de Licence | Gratuit à vie | Disponible sur polar.sh/saidkomi |
Activation de la Clé Pro :
Soit par variable d'environnement dans votre client MCP :
"env": {
"CAROUSEL_LICENSE_KEY": "votre-clé-pro-polar-sh"
}Soit directement lors de l'appel de l'outil render_carousel_project avec le paramètre licenseKey: "votre-clé".
[▸] Installation & Déploiement
Option A : Installation en 1 Clic via Smithery (Recommandé)
npx -y @smithery/cli install mcp-carousel-engine --client claudeOption B : Exécution Directe sans cloner (via NPX)
{
"mcpServers": {
"carousel-engine": {
"command": "npx",
"args": ["-y", "mcp-carousel-engine"],
"env": {
"CAROUSEL_LICENSE_KEY": ""
}
}
}
}Option C : 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 :
{
"mcpServers": {
"carousel-engine": {
"command": "node",
"args": ["c:/VEILLE TECHNOLOGIQUE/laboratoires/agentic-google/mcp-carousel-engine/dist/index.js"]
}
}
}[▸] Outils et Prompts 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 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).
6. list_design_primitives
Liste les primitives de mise en page réutilisables (grille, orbes 3D, badges suspendus, etc.).
Prompt MCP : compose_technical_carousel
Blueprint interactif guidant les modèles d'IA pour structurer en 5 slides percutantes un sujet technique complexe pour Said KOMI avant de déclencher le rendu.
[▸] Exemple de Prompt pour votre Agent IA
"Crée un carrousel de 5 slides sur l'Architecture Zero Trust avec le serveur MCP carousel-engine. Auteur Said KOMI (Ingénieur Réseaux & Système)."
L'agent va :
Consulter
match_design_dnapour sélectionner l'ADNdna-cyber-defense.Structurer le scénario technique en 5 slides percutantes.
Appeler
render_carousel_project.Livrer directement les 5 images PNG prêtes à être publiées sur LinkedIn.
[▸] Auteur & Licence
Concepteur & Architecte : Said KOMI
Rôle : Ingénieur Réseaux et Système
Licence : MIT License
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.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations and no output schema, the description carries the full burden, and it does disclose the substance of what is returned (mandatory rules, 4:5 / 1080x1350 aspect ratios, zero-emoji policy, typography standards) plus the fact that these rules are mandatory rather than advisory. It is silent on return format/structure, but for a zero-parameter read-only fetch this is a strong disclosure.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
One sentence, front-loaded with the verb and resource, with the enumerated contents following immediately. The only padding is the mildly promotional 'world-class carousels', which is minor waste but not enough to hurt structure.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a parameterless tool with no output schema, the description needs to convey the returned content to be useful, and it does via the enumerated rule categories. The remaining gap is that it does not describe the shape/format of the returned rules, but nothing an agent needs to invoke it correctly is missing.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool takes zero parameters, which is the baseline-4 case; there is no parameter semantics to document or omit. The description correctly implies a single unfiltered fetch with no arguments.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb ('Returns') and resource ('mandatory design rules') and then enumerates the actual content (aspect ratios, zero-emoji policy, typography standards), so an agent knows exactly what it gets back. It is clearly distinguishable from the list_* and render_* siblings because it describes a fixed standards payload rather than enumerating options or producing output.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The phrase 'for creating world-class carousels' implies the context of use (fetch these rules before building a carousel), but the description never states when to call this versus list_design_primitives or the other siblings, and offers no exclusions or prerequisites. Usage is only implied, which matches a 3.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
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.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full disclosure burden. It does describe the return payload (archetype names, color palettes, layout suggestions), which is useful behavioral context, but says nothing about read-only safety, permissions, or cost — acceptable gaps only because this is a zero-parameter catalogue lookup.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single front-loaded sentence that names the resource first and then the contents, with no filler. Every clause earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a zero-param, no-output-schema catalogue tool, stating what the payload contains is sufficient. The only real omission is any routing guidance relative to sibling design tools.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool takes zero parameters, so there are no parameter semantics to convey; the baseline for an argument-less tool is 4.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb ('Returns') and resource (a catalogue of creative layout archetypes), and concretizes it with three named examples plus the payload contents. It does not, however, distinguish itself from the sibling list_design_primitives or get_design_rules, which an agent could easily confuse it with.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no when-to-use instruction, no condition, and no mention of alternatives among the sibling tools. The agent must infer usage purely from the fact that it returns a catalogue.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
list_design_primitivesA
Lists all available React design primitives (SlideCanvas, WireframeGrid, ShadedOrb3D, LayeredCard, PillBadge, GradientMaskText, ProfileMedal, CarouselDots) with their props.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. 'Lists' correctly implies a safe read-only operation, and 'with their props' hints at return content beyond the names, but there is no mention of output shape, formatting, or any auth/limits context.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single front-loaded sentence that states the action first and the enumerated contents second. The parenthetical name list is long but directly useful for selection; only minor trimming is possible.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a parameterless listing tool with no output schema, the description covers what is listed and mentions that props accompany each item, which is adequate for calling it correctly. It stops short of describing the returned prop structure, but nothing else is missing.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool takes zero parameters, so the baseline of 4 applies. There is nothing about parameters for the description to clarify or obscure.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb ('Lists') and resource ('React design primitives') and enumerates the exact set returned, so an agent knows precisely what comes back. It is clearly distinguishable from the parallel sibling list_creative_archetypes and from get_design_rules.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no statement of when to use this tool versus get_design_rules, list_creative_archetypes, or render_carousel_project, nor any prerequisite or sequencing guidance. Usage is only implied by the name and the enumeration.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
render_carousel_projectA
Renders a complete 5 to 7 slide carousel into lossless 1080x1350 PNG images and creates an interactive HTML preview.
| Name | Required | Description | Default |
|---|---|---|---|
| topic | Yes | The title / theme of the carousel (e.g. "AWS VPC", "Docker Networking", "React Performance"). | |
| author | Yes | ||
| slides | Yes | List of 5 to 6 slides to generate and render. | |
| themeColor | No | Primary 3D orb / accent color (e.g. "orange", "red", "emerald", "cyan", "violet"). | |
| outputDirectory | Yes | Absolute or relative destination path for the exported PNG images and preview. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden. It usefully discloses the output artifacts and their format (lossless 1080x1350 PNGs, HTML preview), but says nothing about whether outputDirectory is created or overwritten, whether rendering is long-running, or what error conditions exist.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single front-loaded sentence with zero filler that leads with the verb and result artifacts. Nothing is wasted.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description compensates for the absent output schema by naming the produced artifacts, which is valuable. However, for a 5-parameter renderer with nested objects it omits prerequisite and failure behavior, and its '5 to 7 slide' range conflicts with the schema's 'List of 5 to 6 slides'.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 80%, so the schema already documents nearly every parameter, including the nested author and slide objects. The description adds the render-dimension context but no per-parameter meaning beyond what the schema provides, so the baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb (Renders), resource (carousel project), and concrete outputs (1080x1350 lossless PNGs plus an interactive HTML preview). This clearly distinguishes it from the read-only siblings get_design_rules, list_creative_archetypes, and list_design_primitives.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No when-to-use guidance, no prerequisites, and no mention of the sibling tools that supply the design rules or archetypes this renderer presumably consumes. The agent must infer that this is the terminal/execution step of the workflow.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
4 tool updates
v1.0.0- First observed
get_design_rules - First observed
list_creative_archetypes - First observed
list_design_primitives - First observed
render_carousel_project
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
- AlicenseAqualityBmaintenanceProvides structured creative intelligence for ad creatives, enabling AI agents to analyze, tag, and optimize ad performance across 28 dimensions with memory and brand customization.43MIT
- FlicenseNot gradedqualityCmaintenanceEnables AI coding agents to plan, build, and review websites and product interfaces with a persistent, user-led process, including design direction, component contracts, and implementation review.-
- FlicenseNot gradedqualityBmaintenanceEnables 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