# dakkshin/after-effects-mcp architecture

> Architecture diagram of the GitHub repository dakkshin/after-effects-mcp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dakkshin/after-effects-mcp
- Repository: https://github.com/dakkshin/after-effects-mcp

## Overview

The product is an MCP server and After Effects panel bridge: an assistant sends MCP requests, the panel executes commands in the open project, and results return through the bridge. The bridge excerpt shows project operations and result-file handling; the README documents the broader toolset. The excerpts do not show the server’s command-dispatch implementation, so links from the bridge to individual script modules are marked unverified or omitted.

Main entry points: [`src/scripts/mcp-bridge-auto.jsx`](https://github.com/dakkshin/after-effects-mcp/blob/main/src/scripts/mcp-bridge-auto.jsx) (Bridge Panel), [`src/index.ts`](https://github.com/dakkshin/after-effects-mcp/blob/main/src/index.ts) (MCP Server), [`src/scripts/createComposition.jsx`](https://github.com/dakkshin/after-effects-mcp/blob/main/src/scripts/createComposition.jsx) (Create Composition), [`src/scripts/listCompositions.jsx`](https://github.com/dakkshin/after-effects-mcp/blob/main/src/scripts/listCompositions.jsx) (List Compositions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_protocol["MCP Interface"]
  node_server["MCP Server<br/>[index.ts]"]
end

subgraph group_bridge["After Effects Bridge"]
  node_bridge_panel["Bridge Panel"]
  node_ae_project[("After Effects Project")]
end

subgraph group_compositions["Composition Work"]
  node_composition_create["Create Composition"]
  node_composition_list["List Compositions"]
  node_project_info["Project Info<br/>[getProjectInfo.jsx]"]
end

subgraph group_layers["Layer Work"]
  node_layer_info["Layer Info<br/>[getLayerInfo.jsx]"]
  node_layer_properties["Layer Properties"]
  node_text_layer["Text Layers"]
  node_shape_layer["Shape Layers"]
  node_solid_layer["Solid Layers"]
end

subgraph group_animation["Effects &amp; Animation"]
  node_animation_tools["Keyframes &amp; Expressions"]
  node_effect_apply["Apply Effects<br/>[applyEffect.jsx]"]
  node_effect_templates["Effect Templates"]
end

node_assistant(("AI Assistant"))

node_assistant -->|"sends MCP requests"| node_server
node_server -->|"relays commands"| node_bridge_panel
node_bridge_panel -->|"executes project commands"| node_ae_project
node_ae_project -->|"returns results"| node_bridge_panel
node_bridge_panel -.->|"dispatches composition work"| node_composition_create
node_bridge_panel -.->|"dispatches composition queries"| node_composition_list
node_bridge_panel -.->|"dispatches project queries"| node_project_info
node_bridge_panel -.->|"dispatches layer queries"| node_layer_info
node_bridge_panel -.->|"dispatches property edits"| node_layer_properties
node_bridge_panel -.->|"dispatches layer creation"| node_text_layer
node_bridge_panel -.->|"dispatches layer creation"| node_shape_layer
node_bridge_panel -.->|"dispatches layer creation"| node_solid_layer
node_bridge_panel -.->|"dispatches animation tools"| node_animation_tools
node_bridge_panel -.->|"dispatches effect work"| node_effect_apply
node_bridge_panel -.->|"dispatches templates"| node_effect_templates

click node_server "https://github.com/dakkshin/after-effects-mcp/blob/main/src/index.ts"
click node_bridge_panel "https://github.com/dakkshin/after-effects-mcp/blob/main/src/scripts/mcp-bridge-auto.jsx"
click node_composition_create "https://github.com/dakkshin/after-effects-mcp/blob/main/src/scripts/createComposition.jsx"
click node_composition_list "https://github.com/dakkshin/after-effects-mcp/blob/main/src/scripts/listCompositions.jsx"
click node_project_info "https://github.com/dakkshin/after-effects-mcp/blob/main/src/scripts/getProjectInfo.jsx"
click node_layer_info "https://github.com/dakkshin/after-effects-mcp/blob/main/src/scripts/getLayerInfo.jsx"
click node_layer_properties "https://github.com/dakkshin/after-effects-mcp/blob/main/src/scripts/setLayerProperties.jsx"
click node_text_layer "https://github.com/dakkshin/after-effects-mcp/blob/main/src/scripts/createTextLayer.jsx"
click node_shape_layer "https://github.com/dakkshin/after-effects-mcp/blob/main/src/scripts/createShapeLayer.jsx"
click node_solid_layer "https://github.com/dakkshin/after-effects-mcp/blob/main/src/scripts/createSolidLayer.jsx"
click node_animation_tools "https://github.com/dakkshin/after-effects-mcp/tree/main/src/scripts"
click node_effect_apply "https://github.com/dakkshin/after-effects-mcp/blob/main/src/scripts/applyEffect.jsx"
click node_effect_templates "https://github.com/dakkshin/after-effects-mcp/blob/main/src/scripts/applyEffectTemplate.jsx"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_server toneBlue
class node_bridge_panel,node_ae_project toneAmber
class node_composition_create,node_composition_list,node_project_info toneMint
class node_layer_info,node_layer_properties,node_text_layer,node_shape_layer,node_solid_layer toneRose
class node_animation_tools,node_effect_apply,node_effect_templates,node_assistant toneIndigo
```

## Components

### MCP Interface

- [MCP Server](https://github.com/dakkshin/after-effects-mcp/blob/main/src/index.ts): `src/index.ts`

### After Effects Bridge

- [Bridge Panel](https://github.com/dakkshin/after-effects-mcp/blob/main/src/scripts/mcp-bridge-auto.jsx): `src/scripts/mcp-bridge-auto.jsx`
- **After Effects Project**

### Composition Work

- [Create Composition](https://github.com/dakkshin/after-effects-mcp/blob/main/src/scripts/createComposition.jsx): `src/scripts/createComposition.jsx`
- [List Compositions](https://github.com/dakkshin/after-effects-mcp/blob/main/src/scripts/listCompositions.jsx): `src/scripts/listCompositions.jsx`
- [Project Info](https://github.com/dakkshin/after-effects-mcp/blob/main/src/scripts/getProjectInfo.jsx): `src/scripts/getProjectInfo.jsx`

### Layer Work

- [Layer Info](https://github.com/dakkshin/after-effects-mcp/blob/main/src/scripts/getLayerInfo.jsx): `src/scripts/getLayerInfo.jsx`
- [Layer Properties](https://github.com/dakkshin/after-effects-mcp/blob/main/src/scripts/setLayerProperties.jsx): `src/scripts/setLayerProperties.jsx`
- [Text Layers](https://github.com/dakkshin/after-effects-mcp/blob/main/src/scripts/createTextLayer.jsx): `src/scripts/createTextLayer.jsx`
- [Shape Layers](https://github.com/dakkshin/after-effects-mcp/blob/main/src/scripts/createShapeLayer.jsx): `src/scripts/createShapeLayer.jsx`
- [Solid Layers](https://github.com/dakkshin/after-effects-mcp/blob/main/src/scripts/createSolidLayer.jsx): `src/scripts/createSolidLayer.jsx`

### Effects & Animation

- [Keyframes & Expressions](https://github.com/dakkshin/after-effects-mcp/tree/main/src/scripts): `src/scripts`
- [Apply Effects](https://github.com/dakkshin/after-effects-mcp/blob/main/src/scripts/applyEffect.jsx): `src/scripts/applyEffect.jsx`
- [Effect Templates](https://github.com/dakkshin/after-effects-mcp/blob/main/src/scripts/applyEffectTemplate.jsx): `src/scripts/applyEffectTemplate.jsx`

### Other components

- **AI Assistant**

## Connections

- AI Assistant → MCP Server: sends MCP requests (evidence: `README.md`)
- MCP Server → Bridge Panel: relays commands (evidence: `README.md`)
- Bridge Panel → After Effects Project: executes project commands (evidence: `src/scripts/mcp-bridge-auto.jsx`)
- After Effects Project → Bridge Panel: returns results (evidence: `src/scripts/mcp-bridge-auto.jsx`)
- Bridge Panel → Create Composition: dispatches composition work
- Bridge Panel → List Compositions: dispatches composition queries
- Bridge Panel → Project Info: dispatches project queries
- Bridge Panel → Layer Info: dispatches layer queries
- Bridge Panel → Layer Properties: dispatches property edits
- Bridge Panel → Text Layers: dispatches layer creation
- Bridge Panel → Shape Layers: dispatches layer creation
- Bridge Panel → Solid Layers: dispatches layer creation
- Bridge Panel → Keyframes & Expressions: dispatches animation tools
- Bridge Panel → Apply Effects: dispatches effect work
- Bridge Panel → Effect Templates: dispatches templates
