after-effects-mcp MCP — Cas d'usage, Installer & Démo en direct

Pourquoi l'utiliser

Fonctionnalités clés

14+ outils : comps, calques, caméras, nuls, keyframes, expressions, masques
Le panneau pont ExtendScript interroge les commandes — s'exécute dans le processus AE
Fonctionne avec Claude Code via .mcp.json ; autres clients via config manuelle
Supporte les modes de fusion, calques 3D, caches par approche, contour/expansion de masque
Mises à jour de propriétés par lot via batchSetLayerProperties

Démo en direct

Aperçu en pratique

after-effects.replay ▶ prêt

0/0

Installer

Choisissez votre client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "after-effects": {
      "command": "npx",
      "args": [
        "-y",
        "after-effects-mcp"
      ],
      "_inferred": true
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "after-effects": {
      "command": "npx",
      "args": [
        "-y",
        "after-effects-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "after-effects": {
      "command": "npx",
      "args": [
        "-y",
        "after-effects-mcp"
      ],
      "_inferred": true
    }
  }
}

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "after-effects": {
      "command": "npx",
      "args": [
        "-y",
        "after-effects-mcp"
      ],
      "_inferred": true
    }
  }
}

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "after-effects",
      "command": "npx",
      "args": [
        "-y",
        "after-effects-mcp"
      ]
    }
  ]
}

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json

{
  "context_servers": {
    "after-effects": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "after-effects-mcp"
        ]
      }
    }
  }
}

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

claude mcp add after-effects -- npx -y after-effects-mcp

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : after-effects-mcp

Générer des synthés bas d'écran à partir d'un template et d'un CSV

👤 Motion designers réalisant 10+ synthés bas d'écran par épisode ⏱ ~20 min intermediate

Quand l'utiliser : Vous avez un CSV de noms/titres et vous ne voulez pas saisir chacun dans une comp.

Prérequis

After Effects 2022+ avec le panneau pont installé — npm run install-bridge, puis ouvrir mcp-bridge-auto.jsx et cocher 'Auto-run commands'
MCP ajouté via .mcp.json — Pointez vers build/index.js et redémarrez votre client

Déroulement

Créer la comp de base

Create a composition 'LT_01' 1920x1080 29.97 5s black background.✓ Copié

→ La comp apparaît dans AE
Ajouter les calques texte nom + titre

Add text layer 'Dr. Jane Doe' bottom-left at (120, 900) 72pt. Add text layer 'Lead Scientist' below at (120, 960) 36pt.✓ Copié

→ Calques visibles
Ajouter l'animation d'entrée/sortie avec keyframes

Set position keyframes: both text layers slide in from x=-400 between frames 0-15 and slide out from frames 120-135.✓ Copié

→ Synthé animé

Résultat : Un template de synthé fonctionnel que vous pouvez dupliquer/modifier par ligne du CSV.

Pièges

Le panneau pont n'a pas 'Auto-run' coché — les commandes s'empilent sans fin — Ouvrez le panneau et vérifiez la case à chaque relance d'AE
Trop de commandes à la fois gèlent l'UI d'AE — Groupez via batchSetLayerProperties plutôt que 100 appels individuels

Combiner avec : filesystem

Construire une visualisation de données pilotée par expressions

👤 Motion designers faisant des infographies ⏱ ~20 min advanced

Quand l'utiliser : Vous voulez des formes qui s'animent à partir d'un tableau de données sans keyframer chacune.

Déroulement

Créer la forme de base

Create a shape layer 'bar_01' — rectangle, center-anchored, 80x0 at (200,900).✓ Copié

→ Forme à hauteur zéro
Attacher une expression

On bar_01 Scale.y, set expression that grows from 0 to [value] over 30 frames, eased.✓ Copié

→ Expression appliquée, lecture correcte

Résultat : Une forme + expression que vous pouvez répliquer par point de données via une boucle.

Dupliquer un calque de base et ajuster les propriétés par copie

👤 Quiconque réplique un design sur N éléments ⏱ ~10 min beginner

Quand l'utiliser : Vous avez un logo stylisé et il vous faut 12 variations positionnées en cercle.

Déroulement

Dupliquer N fois

Duplicate layer 'logo_base' 12 times, name them logo_00 through logo_11.✓ Copié

→ 12 calques présents
Positionner chacun

For each logo_NN, set position to a point on a 400px radius circle around (960,540), angle = NN * 30 degrees.✓ Copié

→ Anneau de logos

Résultat : Un groupe proprement arrangé en quelques secondes.

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

after-effects + davinci-resolve

Construire du motion design dans AE, finaliser le montage dans Resolve

Build a 6-second title card in After Effects, render to ~/renders/title.mov, then import it at the head of the active Resolve timeline.✓ Copié

after-effects + filesystem

Générer des comps AE à partir de fichiers de données sur le disque

Read ./data/speakers.csv. For each row, create a lower-third comp in AE with that speaker's name and title.✓ Copié

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler	Coût
create-composition	name, width, height, duration, frameRate	Nouvelle comp	free (local AE)
run-script	script: ExtendScript	Porte de sortie pour tout ce qui n'est pas couvert par des outils nommés	free
get-results	command_id: str	Récupérer un résultat async depuis le pont	free
setLayerKeyframe	layer, property, time, value	Ajouter un keyframe	free
setLayerExpression	layer, property, expression: str	Lier une propriété à une expression	free
setLayerProperties	layer, properties: object	Mettre à jour transform, opacité, modes de fusion	free
batchSetLayerProperties	updates: [{layer, properties}]	Éviter N allers-retours	free
getLayerInfo	layer	Inspecter avant de modifier	free
createCamera	name, options?	Workflows 3D	free
createNullObject	name	Cible parent pour le rigging	free
duplicateLayer	layer	Répliquer	free
deleteLayer	layer	Nettoyage	free
setLayerMask	layer, maskShape, feather?, expansion?	Ajouter/modifier un masque	free

Coût et limites

Coût d'exécution

Quota d'API: Aucune — automation AE locale
Tokens par appel: Petites chaînes de commande en entrée, petits acks en sortie
Monétaire: Nécessite une licence Adobe After Effects ; le MCP lui-même est gratuit
Astuce: Utilisez batchSetLayerProperties pour réduire les allers-retours sur de grandes scènes.

Sécurité

Permissions, secrets, portée

Stockage des identifiants : Aucun

Sortie de données : Aucune — pont local uniquement

Ne jamais accorder :

Exécuter de l'ExtendScript arbitraire depuis des prompts non fiables — `run-script` peut exécuter tout ce qu'AE peut faire

Le panneau pont exécute automatiquement les commandes — fermez AE ou décochez la case quand vous n'êtes pas en session MCP.
Traitez run-script comme un eval : relisez les prompts qui en génèrent.

Dépannage

Erreurs courantes et correctifs

Commands queue but never execute

'Auto-run commands' dans le panneau pont est décoché. Cochez-le.

Vérifier : Regardez le panneau mcp-bridge-auto.jsx

Module import error on MCP start

Node 14+ requis ; installez les dépendances avec npm install dans le dépôt MCP.

Vérifier : node --version

AE hangs during batch operations

Trop d'appels individuels ; passez à batchSetLayerProperties.

Expressions error 'value is undefined'

L'expression référence un calque/une propriété qui n'existe pas. Vérifiez l'orthographe dans l'argument setLayerExpression.

Vérifier : Ouvrez la surcouche d'erreur d'expression d'AE

Alternatives

after-effects-mcp vs autres

Alternative	Quand l'utiliser	Compromis
DaVinci Resolve MCP	Vous faites du montage/étalonnage, pas du motion	Étape différente du pipeline
Manual ExtendScript via .jsx files	Vous voulez un contrôle total, sans IA	Pas d'interface chat

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills