Repository navigation
Releases: tzdwindows/after-effects-mcp
Releases · tzdwindows/after-effects-mcp
Release list
v1.1.0 - Complete Package (dist/index.js + Audio Beat Sync + MMS-CTC Aligner + Bundled DOVER-Mobile)
v1.1.0 - Complete Package (dist/index.js + Audio Beat Sync + MMS-CTC Aligner + Bundled DOVER-Mobile)
Latest
After Effects MCP v1.1.0 — 完整打包版 (含 dist/index.js、音画鼓点对齐、MMS/CTC 强制字幕对齐与内置 DOVER-Mobile 视频评分模型)
📦 下载文件说明 (Release Assets)
| 文件名 | 内容与用途说明 |
|---|---|
after-effects-mcp-v1.1.0-complete.zip (推荐下载) |
完整独立打包程序。内含已编译的 dist/index.js (MCP 服务端主程序)、dist/scripts/mcp-bridge-auto.jsx (AE 面板脚本)、内置 DOVER-Mobile 视频质量打分模型 (models/dover_mobile/dover_mobile.onnx)、内置 MMS/CTC 强制字幕对齐模型 (models/mms_fa/ctc_aligner.int8.onnx + silero_vad.onnx)、内置 bin/ffmpeg.exe 解码器、一键安装脚本 install-bridge.bat 以及专用安装说明 INSTALL_GUIDE.md。 |
mcp-bridge-panel-v1.1.0.zip |
仅包含 After Effects 面板脚本 mcp-bridge-auto.jsx 与安装说明,适合仅需单独更新 AE 面板的用户。 |
🚀 三步快速安装与使用指南 (Quick Installation Guide)
第一步:解压并一键安装 AE 桥接面板
- 下载并解压
after-effects-mcp-v1.1.0-complete.zip到任意固定目录(例如D:\after-effects-mcp)。 - Windows 用户:直接双击运行根目录下的
install-bridge.bat(或终端运行npm install && npm run install-bridge)。
macOS / Linux 用户:在终端运行bash install-bridge.sh。自动完成的操作:
- 自动安装/校验
onnxruntime-node原生推理依赖; - 自动查找本机 Adobe After Effects 安装目录并部署
mcp-bridge-auto.jsx到Support Files/Scripts/ScriptUI Panels/; - 自动清理 AE 主菜单与窗口菜单中堆积的历史备份文件(所有备份统一隔离在
~/.ae-mcp/backups/)。
- 自动安装/校验
- 手动安装面板方式(可选):直接将
dist/scripts/mcp-bridge-auto.jsx复制到:- Windows:
C:\Program Files\Adobe\Adobe After Effects <版本>\Support Files\Scripts\ScriptUI Panels\ - macOS:
/Applications/Adobe After Effects <版本>/Scripts/ScriptUI Panels/
- Windows:
第二步:开启 After Effects 脚本权限并打开面板
- 打开 Adobe After Effects。
- 进入 编辑 (Edit) -> 首选项 (Preferences) -> 脚本和表达式 (Scripting & Expressions),勾选 “允许脚本写入文件和访问网络” (Allow Scripts to Write Files and Access Network)。
- 点击顶部菜单 窗口 (Window) ->
mcp-bridge-auto.jsx打开控制台面板,保持 自动执行指令 (Auto-run) 勾选即可。
第三步:在 AI 客户端 (Claude Desktop / Cursor / Cline / Antigravity) 中配置 dist/index.js
在客户端的 MCP 配置文件中添加(请将路径替换为您解压后的实际路径):
{
"mcpServers": {
"after-effects": {
"command": "node",
"args": [
"D:/after-effects-mcp/dist/index.js"
]
}
}
}✨ v1.1.0 核心更新内容 (What's New)
- 彻底修复插件备份添加到 AE 主菜单导致选项堆积的问题:
- 修复了旧版
app.project.save(snapFile)触发 AE “另存为” 导致每次执行操作都将snapshot_*.aep塞入文件 -> 最近打开的文件 (Open Recent)主菜单并篡改当前工程路径的严重 Bug;现改为原位app.project.save()+ 操作系统级静默复制 (File.copy)。 - 面板启动时自动调用
cleanSnapshotEntriesFromMRU()清除 AE 首选项MRU中的历史快照记录。 - 新增
cleanBridgeBackups工具,自动将ScriptUI Panels中的残留备份移至~/.ae-mcp/backups/。
- 修复了旧版
- 新增多频段音频鼓点与节拍检测引擎 (
analyzeAudioRhythm&applyBeatMarkersToComp):- 基于 2048-STFT 与 Ellis (2007) 动态规划节拍追踪,精准提取 BPM、4/4 小节重拍 (Downbeats)、Kick 底鼓 (20–150Hz)、Snare 军鼓 (150–2500Hz)、Hi-Hat 踩镲 (2500–10500Hz)、强冲击点及前奏/铺垫/高潮爆发分段,并支持一键在 AE 合成时间线上生成彩色鼓点标记。
- 新增内置 MMS-Align / CTC-Segmentation 声学强制字幕对齐引擎 (
alignLyricsWithMMS&createAlignedLyricLayers):- 内置神经声学 CTC 模型 (
models/mms_fa/ctc_aligner.int8.onnx) +silero_vad_v6.onnx+ Kürzinger et al. (2020) Viterbi CTC-Segmentation 算法,精准对齐每个词/字的起止毫秒时间、修正 LRC 偏移、计算鼓点毫秒差,并支持一键生成 3D 卡点字幕图层。
- 内置神经声学 CTC 模型 (
- 新增内置官方 DOVER-Mobile 视频质量与音画同步评分模型 (
evaluateVideoWithDOVER):- 内置官方 DOVER-Mobile (
ConvNeXtV2-Femto-3D,models/dover_mobile/dover_mobile.onnx) 模型,对渲染视频进行 技术质量评分 (TQE)、美学质量评分 (AQE)、综合质量总分 (0–100) 与 音画鼓点同步率评分 (0–100),并提供分时段画面诊断与 AI 改进建议。
- 内置官方 DOVER-Mobile (
v1.0.0 - Initial Release (See v1.1.0 for Complete Package with dist/index.js & Bundled Models)
After Effects MCP v1.1.0 — 完整打包版 (含 dist/index.js、音画鼓点对齐、MMS/CTC 强制字幕对齐与内置 DOVER-Mobile 视频评分模型)
📦 下载文件说明 (Release Assets)
| 文件名 | 内容与用途说明 |
|---|---|
after-effects-mcp-v1.1.0-complete.zip (推荐下载) |
完整独立打包程序。内含已编译的 dist/index.js (MCP 服务端主程序)、dist/scripts/mcp-bridge-auto.jsx (AE 面板脚本)、内置 DOVER-Mobile 视频质量打分模型 (models/dover_mobile/dover_mobile.onnx)、内置 MMS/CTC 强制字幕对齐模型 (models/mms_fa/ctc_aligner.int8.onnx + silero_vad.onnx)、内置 bin/ffmpeg.exe 解码器、一键安装脚本 install-bridge.bat 以及专用安装说明 INSTALL_GUIDE.md。 |
mcp-bridge-panel-v1.1.0.zip |
仅包含 After Effects 面板脚本 mcp-bridge-auto.jsx 与安装说明,适合仅需单独更新 AE 面板的用户。 |
🚀 三步快速安装与使用指南 (Quick Installation Guide)
第一步:解压并一键安装 AE 桥接面板
- 下载并解压
after-effects-mcp-v1.1.0-complete.zip到任意固定目录(例如D:\after-effects-mcp)。 - Windows 用户:直接双击运行根目录下的
install-bridge.bat(或终端运行npm install && npm run install-bridge)。
macOS / Linux 用户:在终端运行bash install-bridge.sh。自动完成的操作:
- 自动安装/校验
onnxruntime-node原生推理依赖; - 自动查找本机 Adobe After Effects 安装目录并部署
mcp-bridge-auto.jsx到Support Files/Scripts/ScriptUI Panels/; - 自动清理 AE 主菜单与窗口菜单中堆积的历史备份文件(所有备份统一隔离在
~/.ae-mcp/backups/)。
- 自动安装/校验
- 手动安装面板方式(可选):直接将
dist/scripts/mcp-bridge-auto.jsx复制到:- Windows:
C:\Program Files\Adobe\Adobe After Effects <版本>\Support Files\Scripts\ScriptUI Panels\ - macOS:
/Applications/Adobe After Effects <版本>/Scripts/ScriptUI Panels/
- Windows:
第二步:开启 After Effects 脚本权限并打开面板
- 打开 Adobe After Effects。
- 进入 编辑 (Edit) -> 首选项 (Preferences) -> 脚本和表达式 (Scripting & Expressions),勾选 “允许脚本写入文件和访问网络” (Allow Scripts to Write Files and Access Network)。
- 点击顶部菜单 窗口 (Window) ->
mcp-bridge-auto.jsx打开控制台面板,保持 自动执行指令 (Auto-run) 勾选即可。
第三步:在 AI 客户端 (Claude Desktop / Cursor / Cline / Antigravity) 中配置 dist/index.js
在客户端的 MCP 配置文件中添加(请将路径替换为您解压后的实际路径):
{
"mcpServers": {
"after-effects": {
"command": "node",
"args": [
"D:/after-effects-mcp/dist/index.js"
]
}
}
}✨ v1.1.0 核心更新内容 (What's New)
- 彻底修复插件备份添加到 AE 主菜单导致选项堆积的问题:
- 修复了旧版
app.project.save(snapFile)触发 AE “另存为” 导致每次执行操作都将snapshot_*.aep塞入文件 -> 最近打开的文件 (Open Recent)主菜单并篡改当前工程路径的严重 Bug;现改为原位app.project.save()+ 操作系统级静默复制 (File.copy)。 - 面板启动时自动调用
cleanSnapshotEntriesFromMRU()清除 AE 首选项MRU中的历史快照记录。 - 新增
cleanBridgeBackups工具,自动将ScriptUI Panels中的残留备份移至~/.ae-mcp/backups/。
- 修复了旧版
- 新增多频段音频鼓点与节拍检测引擎 (
analyzeAudioRhythm&applyBeatMarkersToComp):- 基于 2048-STFT 与 Ellis (2007) 动态规划节拍追踪,精准提取 BPM、4/4 小节重拍 (Downbeats)、Kick 底鼓 (20–150Hz)、Snare 军鼓 (150–2500Hz)、Hi-Hat 踩镲 (2500–10500Hz)、强冲击点及前奏/铺垫/高潮爆发分段,并支持一键在 AE 合成时间线上生成彩色鼓点标记。
- 新增内置 MMS-Align / CTC-Segmentation 声学强制字幕对齐引擎 (
alignLyricsWithMMS&createAlignedLyricLayers):- 内置神经声学 CTC 模型 (
models/mms_fa/ctc_aligner.int8.onnx) +silero_vad_v6.onnx+ Kürzinger et al. (2020) Viterbi CTC-Segmentation 算法,精准对齐每个词/字的起止毫秒时间、修正 LRC 偏移、计算鼓点毫秒差,并支持一键生成 3D 卡点字幕图层。
- 内置神经声学 CTC 模型 (
- 新增内置官方 DOVER-Mobile 视频质量与音画同步评分模型 (
evaluateVideoWithDOVER):- 内置官方 DOVER-Mobile (
ConvNeXtV2-Femto-3D,models/dover_mobile/dover_mobile.onnx) 模型,对渲染视频进行 技术质量评分 (TQE)、美学质量评分 (AQE)、综合质量总分 (0–100) 与 音画鼓点同步率评分 (0–100),并提供分时段画面诊断与 AI 改进建议。
- 内置官方 DOVER-Mobile (