JS

after-effects-mcp

by Dakkshin/after-effects-mcp

0 views

MCP Server for Adobe After Effects. Enables remote control (compositions, text, shapes, solids, properties) via the Model Context Protocol using ExtendScript.

automationnodejsjavascriptVideo & Audio

๐ŸŽฌ After Effects MCP Server

Node.js Build License Platform

โœจ A Model Context Protocol (MCP) server for Adobe After Effects that enables AI assistants and other applications to control After Effects through a standardized protocol.

mcp-after-effects MCP server

Table of Contents

๐Ÿ“ฆ Features

๐ŸŽฅ Core Composition Features

  • Create compositions with custom settings (size, frame rate, duration, background color)
  • List all compositions in a project
  • Get project information such as frame rate, dimensions, and duration

๐Ÿงฑ Layer Management

  • Create text layers with customizable properties (font, size, color, position)
  • Create shape layers (rectangle, ellipse, polygon, star) with colors and strokes
  • Create solid/adjustment layers for backgrounds and effects
  • Modify layer properties like position, scale, rotation, opacity, and timing

๐ŸŒ€ Animation Capabilities

  • Set keyframes for layer properties (Position, Scale, Rotation, Opacity, etc.)
  • Apply expressions to layer properties for dynamic animations

โš™๏ธ Setup Instructions

๐Ÿ›  Prerequisites

  • Adobe After Effects (2022 or later)
  • Node.js (v14 or later)
  • npm or yarn package manager

๐Ÿ“ฅ Installation

  1. Clone the repository

    git clone https://github.com/Dakkshin/after-effects-mcp.git
    cd after-effects-mcp
    
  2. Install dependencies

    npm install
    # or
    yarn install
    
  3. Build the project

    npm run build
    # or
    yarn build
    
  4. Install the After Effects panel

    npm run install-bridge
    # or
    yarn install-bridge
    

    This will copy the necessary scripts to your After Effects installation.

๐Ÿ”ง Update MCP Config

Go to your client (eg. Claude or Cursor ) and update your config file

{
  "mcpServers": {
    "AfterEffectsMCP": {
      "command": "node",
      "args": ["C:\\Users\\Dakkshin\\after-effects-mcp\\build\\index.js"]
    }
  }
}

โ–ถ๏ธ Running the Server

  1. Start the MCP server

    npm start
    # or
    yarn start
    
  2. Open After Effects

  3. Open the MCP Bridge Auto panel

    • In After Effects, go to Window > mcp-bridge-auto.jsx
    • The panel will automatically check for commands every few seconds
    • Make sure the "Auto-run commands" checkbox is enabled

๐Ÿš€ Usage Guide

Once you have the server running and the MCP Bridge panel open in After Effects, you can control After Effects through the MCP protocol. This allows AI assistants or custom applications to send commands to After Effects.

๐Ÿ“˜ Creating Compositions

You can create new compositions with custom settings:

  • Name
  • Width and height (in pixels)
  • Frame rate
  • Duration
  • Background color

Example MCP tool usage (for developers):

mcp_aftereffects_create_composition({
  name: "My Composition", 
  width: 1920, 
  height: 1080, 
  frameRate: 30,
  duration: 10
});

โœ๏ธ Working with Layers

You can create and modify different types of layers:

Text layers:

  • Set text content, font, size, and color
  • Position text anywhere in the composition
  • Adjust timing and opacity

Shape layers:

  • Create rectangles, ellipses, polygons, and stars
  • Set fill and stroke colors
  • Customize size and position

Solid layers:

  • Create background colors
  • Make adjustment layers for effects

๐Ÿ•น Animation

You can animate layers with:

Keyframes:

  • Set property values at specific times
  • Create motion, scaling, rotation, and opacity changes
  • Control the timing of animations

Expressions:

  • Apply JavaScript expressions to properties
  • Create dynamic, procedural animations
  • Connect property values to each other

๐Ÿ›  Available MCP Tools

CommandDescription
`create-composition`Create a new comp
`run-script`Run a JS script inside AE
`get-results`Get script results
`get-help`Help for available commands
`setLayerKeyframe`Add keyframe to layer property
`setLayerExpression`Add/remove expressions from properties

๐Ÿ‘จโ€๐Ÿ’ป For Developers

๐Ÿงฉ Project Structure

  • src/index.ts: MCP server implementation
  • src/scripts/mcp-bridge-auto.jsx: Main After Effects panel script
  • install-bridge.js: Script to install the panel in After Effects

๐Ÿ“ฆ Building the Project

npm run build
# or
yarn build

๐Ÿค Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Install

{
  "mcpServers": {
    "after-effects-mcp": {
      "command": "node",
      "args": [
        "C:\\Users\\Dakkshin\\after-effects-mcp\\build\\index.js"
      ]
    }
  }
}
For more configuration details, refer to the content on the left

Related

Related projects feature coming soon

Will recommend related projects based on sub-categories