After Effects MCP

🚀 Adobe After Effects MCP Server

The Adobe After Effects MCP Server provides a comprehensive solution for creating, managing, and animating compositions in Adobe After Effects. It simplifies complex tasks and offers a wide range of features to enhance your creative workflow.

🚀 Quick Start

To get started with the Adobe After Effects MCP Server, you need to meet the following prerequisites and follow the installation steps:

Prerequisites

• Node.js (version 14 or higher).
• Adobe After Effects software.

Installation Steps

1. Clone the project repository:

   git clone https://github.com/your-repository.git
   

2. Install the dependencies:

   npm install
   

3. Load the script file src/scripts/mcp-bridge-auto.jsx in After Effects.

✨ Features

Core Composition Functions

• Create and manage new compositions.
• Set the resolution, frame rate, and duration of compositions.

Layer Management

• Create and manipulate different types of layers (text, shape, solid layers).
• Adjust the position, scale, rotation, and opacity of layers.

Animation Functions

• Add keyframes to control property changes.
• Apply JavaScript expressions to achieve dynamic animation effects.

💻 Usage Examples

Basic Usage

Create a Composition

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

Manipulate Layers

Text Layer

• Create text and set properties:

  setLayerText("myLayer", "Hello World!", { fontSize: 24, color: "#ff0000" });
  

• Adjust position and animate:

  moveLayerToPosition("myLayer", { x: 500, y: 300 }, 1);
  

Shape Layer

• Create a rectangle and set properties:

  createShapeLayer("rectangle", {
    position: [100, 100],
    size: [200, 100],
    fillColor: "#00ff00"
  });
  

Solid Layer

• Create a background color layer:

  createSolidLayer("bg", { position: [0, 0], size: [1920, 1080], fillColor: "#ffffff" });
  

Animation

Keyframes

• Add position animation:

  setLayerKeyframe("myLayer", "position", [
    { time: 0, value: [100, 100] },
    { time: 2, value: [500, 300] }
  ]);
  

Expressions

• Apply a position offset expression:

  setLayerExpression("myLayer", "positionOffset", "time * 10");
  

📚 Documentation

Developer Information

Project Structure

• src/index.ts: Implementation of the MCP server.
• src/scripts/mcp-bridge-auto.jsx: Main After Effects script file.

Build the Project

npm run build

Contribution Guidelines

Pull requests are welcome! Please ensure that your code adheres to the coding standards and includes detailed comments.

📄 License

This project is licensed under the MIT License. For more details, please refer to the LICENSE file.