/ 目錄 / 演練場 / after-effects-mcp
● 社群 Dakkshin ⚡ 即開即用

after-effects-mcp

作者 Dakkshin · Dakkshin/after-effects-mcp

透過聊天介面操控 After Effects — 建立合成、新增圖層、設定關鍵影格與運算式 — 透過 ExtendScript 橋接面板實現。

Dakkshin 開發的 after-effects-mcp 透過自動執行的橋接面板包裝 Adobe AE 的 ExtendScript。安裝完成後,MCP 可建立合成、新增文字/形狀/固態層/攝影機/空物件、設定關鍵影格與運算式,並操控遮罩 — 全部透過 Claude Code 等 MCP 客戶端完成。需要 AE 2022+ 及 Node 14+ 以上版本。

為什麼要用

核心特性

即時演示

實際使用效果

after-effects.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "after-effects": {
      "command": "npx",
      "args": [
        "-y",
        "after-effects-mcp"
      ],
      "_inferred": true
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "after-effects": {
      "command": "npx",
      "args": [
        "-y",
        "after-effects-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "after-effects": {
      "command": "npx",
      "args": [
        "-y",
        "after-effects-mcp"
      ],
      "_inferred": true
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "after-effects": {
      "command": "npx",
      "args": [
        "-y",
        "after-effects-mcp"
      ],
      "_inferred": true
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "after-effects",
      "command": "npx",
      "args": [
        "-y",
        "after-effects-mcp"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "after-effects": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "after-effects-mcp"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add after-effects -- npx -y after-effects-mcp

一行命令搞定。用 claude mcp list 驗證,claude mcp remove 移除。

使用場景

實戰用法: after-effects-mcp

從 CSV 批次產生基於範本的字幕條

👤 每集需製作 10 個以上字幕條的動態圖像設計師 ⏱ ~20 min intermediate

何時使用: 你有一份包含姓名/職稱的 CSV,不想逐一手動輸入到合成中。

前置條件
  • 已安裝橋接面板的 After Effects 2022+ — 執行 npm run install-bridge,然後開啟 mcp-bridge-auto.jsx 並勾選「Auto-run commands」
  • 透過 .mcp.json 新增 MCP — 指向 build/index.js 並重新啟動客戶端
步驟
  1. 建立基礎合成
    建立一個合成 'LT_01',1920x1080,29.97,5 秒,黑色背景。✓ 已複製
    → 合成出現在 AE 中
  2. 新增姓名與職稱文字圖層
    在左下方 (120, 900) 位置新增文字圖層 'Dr. Jane Doe',72pt。在 (120, 960) 位置新增文字圖層 'Lead Scientist',36pt。✓ 已複製
    → 圖層可見
  3. 加入進出動畫關鍵影格
    設定位置關鍵影格:兩個文字圖層在第 0-15 影格從 x=-400 滑入,並在第 120-135 影格滑出。✓ 已複製
    → 字幕條具備動畫效果

結果: 產生一個可運作的字幕條範本,讓你能依 CSV 每一列複製並編輯。

注意事項
  • 橋接面板未勾選「Auto-run」— 指令永遠排隊等待 — 開啟面板並在每次 AE 重新啟動後確認核取方塊已勾選
  • 一次傳送過多指令導致 AE 介面凍結 — 改用 batchSetLayerProperties 進行批次處理,而非發送 100 個個別呼叫
搭配使用: filesystem

建立運算式驅動的資料視覺化

👤 製作資訊圖表的動態設計師 ⏱ ~20 min advanced

何時使用: 你希望形狀能從資料陣列動畫化,而不需為每個形狀設定關鍵影格。

步驟
  1. 建立基礎形狀
    建立一個形狀圖層 'bar_01' — 矩形,中心錨點,80x0,位於 (200,900)。✓ 已複製
    → 形狀高度為零
  2. 套用運算式
    在 bar_01 的 Scale.y 上,設定運算式使其在 30 影格內從 0 成長到 [value],並加入緩動。✓ 已複製
    → 運算式已套用,播放正確

結果: 一個形狀加運算式的組合,可透過迴圈依每個資料點複製。

複製基礎圖層並逐一調整各副本屬性

👤 需要將設計複製到 N 個項目的任何人 ⏱ ~10 min beginner

何時使用: 你有一個已設計好的 logo,需要建立 12 個變體並排列在圓形上。

步驟
  1. 複製 N 次
    將圖層 'logo_base' 複製 12 次,命名為 logo_00 至 logo_11。✓ 已複製
    → 12 個圖層存在
  2. 逐一定位
    對每個 logo_NN,將位置設定為以 (960,540) 為圓心、半徑 400px 的圓上的對應點,角度 = NN * 30 度。✓ 已複製
    → Logo 排列成環形

結果: 在數秒內完成整齊排列的群組。

組合

與其他 MCP 搭配,撬動十倍槓桿

after-effects + davinci-resolve

在 AE 中建立動態圖像,在 Resolve 中完成剪輯

在 After Effects 中建立一個 6 秒的片頭卡,算圖輸出至 ~/renders/title.mov,然後將其匯入目前 Resolve 時間軸的開頭。✓ 已複製
after-effects + filesystem

從磁碟上的資料檔案產生 AE 合成

讀取 ./data/speakers.csv。對每一列,在 AE 中建立一個包含該講者姓名與職稱的字幕條合成。✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
create-composition name, width, height, duration, frameRate 建立新合成 free (local AE)
run-script script: ExtendScript 當具名工具無法涵蓋需求時的萬用逃生出口 free
get-results command_id: str 從橋接器取回非同步執行結果 free
setLayerKeyframe layer, property, time, value 新增關鍵影格 free
setLayerExpression layer, property, expression: str 將屬性綁定至運算式 free
setLayerProperties layer, properties: object 更新變換、不透明度、混合模式 free
batchSetLayerProperties updates: [{layer, properties}] 避免 N 次來回傳輸 free
getLayerInfo layer 修改前先檢查圖層資訊 free
createCamera name, options? 3D 工作流程 free
createNullObject name 作為綁定目標的父層 free
duplicateLayer layer 複製圖層 free
deleteLayer layer 清理圖層 free
setLayerMask layer, maskShape, feather?, expansion? 新增或修改遮罩 free

成本與限制

運行它的成本

API 配額
無 — 本機 AE 自動化
每次呼叫 Token 數
輸入為極小的指令字串,輸出為極小的確認訊息
費用
需要 Adobe After Effects 授權;MCP 本身免費
提示
使用 batchSetLayerProperties 減少大型場景的來回傳輸次數。

安全

權限、密鑰、影響範圍

憑證儲存:
資料出站: 無 — 僅限本機橋接
切勿授予: Run arbitrary ExtendScript from untrusted prompts — `run-script` can execute anything AE can

故障排查

常見錯誤與修復

Commands queue but never execute

橋接面板中的「Auto-run commands」未勾選,請勾選它。

驗證: Look at mcp-bridge-auto.jsx panel
Module import error on MCP start

需要 Node 14+;在 MCP 儲存庫中執行 npm install 安裝相依套件。

驗證: node --version
AE hangs during batch operations

個別呼叫次數過多;請改用 batchSetLayerProperties。

Expressions error 'value is undefined'

運算式參照了不存在的圖層或屬性,請仔細確認 setLayerExpression 參數的拼寫是否正確。

驗證: Open AE's expression error overlay

替代方案

after-effects-mcp 對比其他方案

替代方案何時用它替代權衡
DaVinci Resolve MCP你正在進行剪輯/調色,而非動態圖像製作屬於不同的製作流程階段
Manual ExtendScript via .jsx files你想要完全掌控,不需要 AI 介入沒有聊天介面

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills