Aftereffects MCP

Brandkick

由您呈现 布兰德里克 -我们把品牌当作自己的品牌来发展。

______________________________________________________________________

After Effects MCP服务器

Adobe After Effects的模型上下文协议服务器。使AI助手能够通过基于WebSocket的CEP面板控制After Effects。

需求

• Adobe After Effects 2021+（版本18.x-26.x）
• Node.js 18+
• pnpm

安装

git clone https://github.com/Brandkick/after-effects-mcp.git
cd after-effects-mcp
pnpm install
just setup

配置

添加到Claude代码配置(~/.claude.json):

{
  "mcpServers": {
    "aftereffects": {
      "command": "node",
      "args": ["/path/to/after-effects-mcp/build/index.js"]
    }
  }
}

用法

1. Claude Code自动启动MCP服务器
2. 打开后效果
3. 打开面板：窗口>扩展>MCP桥

设置：JPEG输出模板

对于 exportCompFrame 要工作，请在After Effects中创建JPEG输出模板：

1. 创作任何作品
2. 文件>导出>添加到渲染队列
3. 点击“输出模块”设置
4. 将格式设置为“JPEG序列”
5. 将“质量”设置为50-70%（预览速度更快，文件更小）
6. 可选调整大小：选中“调整大小”并设置为50%或固定大小，如960x540
7. 单击模板下拉列表（对话框顶部）
8. 选择“另存为新模板…”
9. 准确命名： JPEG Sequence
10. 单击“确定”

每次安装After Effects只需要完成一次。

MCP工具

命令

所有命令都可以通过以下方式调用 run-script.使用 getHelp 查看完整文档。

项目

• getProjectInfo, newProject, saveProject, saveProjectAs, closeProject
• createFolder, moveProjectItem, deleteProjectItem
• importFootage, importPlaceholder, replaceFootage

构图

• listCompositions, getActiveComposition, createComposition
• setCompSettings -修改持续时间、工作区域、帧率、运动模糊

图层

• createTextLayer, createShapeLayer, createSolidLayer, addLayerToComp
• getLayerInfo, setLayerProperties -名称、转换、计时
• setLayerFlags -可见性、单人、害羞、锁定、运动模糊、3D
• deleteLayer, duplicateLayer, reorderLayer, precomposeLayer
• setParentLayer, setTrackMatte
• setTextProperties -字体、大小、颜色、对齐方式

动画

• setLayerKeyframe, setLayerKeyframes （批次）
• setLayerExpression
• getKeyframes, deleteKeyframe, deleteKeyframes （批次）
• setKeyframeEasing, setKeyframesEasing （批次）
• copyKeyframes

效果

• applyEffect, applyEffectTemplate
• listEffects, listAvailableEffects, getEffectProperties
• setEffectKeyframe, setEffectKeyframes （批次）

时间和标记

• setLayerTime -进出点、开始时间、伸展
• enableTimeRemapping, setTimeRemap
• addMarker, getMarkers, removeMarker

相机和3D

• createCamera, createLight
• setCameraProperties, setLightProperties
• set3DLayer, setMaterialOptions

面具和形状

• addMask, setMaskPath, setMaskProperties, deleteMask
• addShapePath, setShapePathVertices, addShapeModifier

渲染

• addToRenderQueue, renderQueue, queueInAME
• getRenderQueueStatus, clearRenderQueue
• exportCompFrame -目视验证

效用

• getSelection, setSelection
• beginUndoGroup, endUndoGroup, getUndoGroupStatus
• getPropertyInfo, listFonts

MCP资源

发展

just setup   # Build and install CEP panel with debug mode
just build   # Build only
just start   # Start MCP server (for testing)
just clean   # Remove build directory

建筑

Claude Code  MCP Server  CEP Panel  ExtendScript

看 建筑.md 设计原则。

项目结构

after-effects-mcp/
├── src/
│   ├── index.ts              # MCP server, tool definitions
│   ├── websocket-server.ts   # WebSocket server
│   ├── logger.ts             # Logging utility
│   ├── shared/
│   │   ├── commands.ts       # Command registry (single source of truth)
│   │   └── config.ts         # Configuration and timeouts
│   └── cep/                   # CEP extension
│       ├── CSXS/manifest.xml
│       ├── index.html
│       ├── js/main.js         # WebSocket client
│       └── jsx/modules/       # ExtendScript (modular)
│           ├── 00-polyfills.jsx
│           ├── 01-helpers.jsx
│           ├── 10-project.jsx
│           ├── 11-layer.jsx
│           ├── 12-keyframe.jsx
│           ├── 13-time.jsx
│           ├── 14-render.jsx
│           ├── 15-camera.jsx
│           ├── 16-mask.jsx
│           ├── 17-shape.jsx
│           ├── 18-selection.jsx
│           ├── 19-discovery.jsx
│           └── 99-dispatcher.jsx
├── scripts/
│   ├── install-cep.js
│   ├── build-jsx.ts          # Concatenates JSX modules
│   └── generate-cep-config.ts
├── tests/
├── justfile
└── package.json

许可证

麻省理工学院