🎬 After Effects MCP服务器
✨ Adobe After Effects的模型上下文协议（MCP）服务器，使AI助手和其他应用程序能够通过标准化协议控制After Effects。
目录
📦 特性
🎥 核心组成特征
- 创作作品 具有自定义设置（大小、帧率、持续时间、背景颜色）
- 列出所有作品 在一个项目中
- 获取项目信息 例如帧率、尺寸和持续时间
🧱 层管理
- 创建文本图层 具有可自定义的属性（字体、大小、颜色、位置）
- 创建形状层 （矩形、椭圆形、多边形、星形），带颜色和笔划
- 创建实体/调整图层 背景和效果
- 修改图层特性 如位置、比例、旋转、不透明度和定时
🌀 动画能力
- 设置关键帧 用于图层属性（位置、比例、旋转、不透明度等）
- 应用表达式 为动态动画添加图层属性
⚙️ 安装说明
🛠 先决条件
- Adobe After Effects（2022或更高版本）
- Node.js（v14或更高版本）
- npm或yarn包管理器
📥 安装
- 克隆存储库
git clone https://github.com/Dakkshin/after-effects-mcp.git
cd after-effects-mcp- 安装依赖项
npm install
# or
yarn install- 构建项目
npm run build
# or
yarn build- 安装After Effects面板
npm run install-bridge
# or
yarn install-bridge这将把必要的脚本复制到After Effects安装中。
🔧 更新MCP配置
转到您的客户端（例如Claude或Cursor）并更新配置文件
{
"mcpServers": {
"AfterEffectsMCP": {
"command": "node",
"args": ["C:\\Users\\Dakkshin\\after-effects-mcp\\build\\index.js"]
}
}
}▶️ 运行服务器
- 启动MCP服务器
npm start
# or
yarn start- 打开后效果
- 打开MCP桥接自动面板
- 在After Effects中，转到窗口>mcp-bridge-auto.jsx - 面板将每隔几秒钟自动检查一次命令 - 确保“自动运行命令”复选框已启用
🚀 使用指南
在After Effects中运行服务器并打开MCP网桥面板后，您可以通过MCP协议控制After Effects。这允许AI助手或自定义应用程序向After Effects发送命令。
📘 创作作品
您可以使用自定义设置创建新组合：
- 名字
- 宽度和高度（像素）
- 帧率
- 持续时间
- 背景颜色
MCP工具使用示例（面向开发人员）：
mcp_aftereffects_create_composition({
name: "My Composition",
width: 1920,
height: 1080,
frameRate: 30,
duration: 10
});✍️ 使用图层
您可以创建和修改不同类型的图层：
文本图层：
- 设置文本内容、字体、大小和颜色
- 将文本放置在作文中的任何位置
- 调整定时和不透明度
形状层：
- 创建矩形、椭圆、多边形和星形
- 设置填充和笔划颜色
- 自定义大小和位置
固体层：
- 创建背景颜色
- 为效果制作调整层
🕹 动画
您可以通过以下方式设置图层动画：
关键帧：
- 在特定时间设置属性值
- 创建运动、缩放、旋转和不透明度更改
- 控制动画的播放时间
表达：
- 将JavaScript表达式应用于属性
- 创建动态程序动画
- 将属性值相互连接
🛠 可用的MCP工具
| 命令 | 描述 |
|---|---|
\create composition\ | 创建一个新的comp |
\run script\ | 在AE中运行JS脚本 |
| “获取结果” | 获取脚本结果 |
| “获取帮助” | 可用命令的帮助 |
\setLayerKeyframe\ | 将关键帧添加到图层属性 |
\setLayerExpression \ | 在属性中添加/删除表达式 |
👨💻 对于开发者
🧩 项目结构
src/index.ts：MCP服务器实现src/scripts/mcp-bridge-auto.jsx：主After Effects面板脚本install-bridge.js：在After Effects中安装面板的脚本
📦 建设项目
npm run build
# or
yarn build🤝 贡献
欢迎投稿！请随时提交拉取请求。
许可证
此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。