After Effects MCP

🚀 Adobe After Effects MCP 服務器

🎬 Adobe After Effects MCP 服務器是一個強大的工具，可用於創建、管理合成，操作層以及實現動畫效果。它基於 Node.js 運行，與 Adobe After Effects 軟件深度集成，為用戶提供便捷的創作體驗。

🚀 快速開始

本項目需要 Node.js（版本 14 或更高）和 Adobe After Effects 軟件。請按照以下步驟完成安裝：

1. 克隆項目倉庫：

   git clone https://github.com/your-repository.git
   

2. 安裝依賴項：

   npm install
   

3. 在 After Effects 中加載腳本文件 src/scripts/mcp-bridge-auto.jsx。

✨ 主要特性

核心合成功能

• 能夠創建和管理新的合成，還可靈活設置合成的分辨率、幀率和時長。

層管理

• 支持創建和操作不同類型的層，如文本、形狀、固態層，並且可以調整層的位置、縮放、旋轉和不透明度。

動畫功能

• 可添加關鍵幀以精準控制屬性變化，還能應用 JavaScript 表達式實現動態動畫效果。

📦 安裝指南

先決條件

• Node.js（版本 14 或更高）。
• Adobe After Effects 軟件。

安裝步驟

1. 克隆項目倉庫：

   git clone https://github.com/your-repository.git
   

2. 安裝依賴項：

   npm install
   

3. 在 After Effects 中加載腳本文件 src/scripts/mcp-bridge-auto.jsx。

💻 使用示例

基礎用法

創建合成

mcp_aftereffects_create_composition({
  name: "My Composition",
  width: 1920,
  height: 1080,
  frameRate: 30,
  duration: 10
});

操作層

文本層

• 創建文本並設置屬性：

  setLayerText("myLayer", "Hello World!", { fontSize: 24, color: "#ff0000" });
  

• 調整位置和動畫：

  moveLayerToPosition("myLayer", { x: 500, y: 300 }, 1);
  

形狀層

• 創建矩形並設置屬性：

  createShapeLayer("rectangle", {
    position: [100, 100],
    size: [200, 100],
    fillColor: "#00ff00"
  });
  

固態層

• 創建背景顏色層：

  createSolidLayer("bg", { position: [0, 0], size: [1920, 1080], fillColor: "#ffffff" });
  

動畫

關鍵幀

• 添加位置動畫：

  setLayerKeyframe("myLayer", "position", [
    { time: 0, value: [100, 100] },
    { time: 2, value: [500, 300] }
  ]);
  

表達式

• 應用位置偏移表達式：

  setLayerExpression("myLayer", "positionOffset", "time * 10");
  

📚 詳細文檔

開發者信息

項目結構

• src/index.ts：MCP 服務器實現。
• src/scripts/mcp-bridge-auto.jsx：主 After Effects 腳本文件。

構建項目

npm run build

貢獻指南

歡迎提交 Pull Request！請確保代碼符合規範幷包含詳細的註釋。

📄 許可證

本項目使用 MIT License。詳細信息請參閱 LICENSE 文件。