🎬 After Effects MCP Server

🎬 After Effects MCP サーバー

✨ Adobe After Effects 用の Model Context Protocol（MCP）サーバーです。標準化されたプロトコルを通じて、AI アシスタントやその他のアプリケーションから After Effects を操作できます。

目次

• 機能
  • コンポジションの基本機能
  • レイヤー管理
  • アニメーション機能
• セットアップ手順
  • 前提条件
  • インストール
  • MCP 設定の更新
  • サーバーの実行
• 使用ガイド
  • コンポジションの作成
  • レイヤーの操作
  • アニメーション
• 利用可能な MCP ツール
• 開発者向け
  • プロジェクト構成
  • プロジェクトのビルド
  • コントリビューション
• ライセンス

📦 機能

🎥 コンポジションの基本機能

• コンポジションの作成：サイズ、フレームレート、長さ、背景色などの設定をカスタマイズできます
• プロジェクト内のすべてのコンポジションの一覧表示
• プロジェクト情報の取得：フレームレート、寸法、長さなどを確認できます

🧱 レイヤー管理

• テキストレイヤーの作成：フォント、サイズ、色、位置などのプロパティをカスタマイズできます
• シェイプレイヤーの作成：長方形、楕円、多角形、星形を作成でき、色や線を設定できます
• 平面レイヤー／調整レイヤーの作成：背景やエフェクトに使用できます
• カメラレイヤーの作成：ズームや位置を設定できます
• ヌルオブジェクトの作成：アニメーションを制御できます
• レイヤープロパティの変更：位置、スケール、回転、不透明度、タイミングなどを変更できます
• レイヤーの 2D／3D モードの切り替え
• 描画モードの設定：通常、乗算、スクリーンなどを設定できます
• トラックマットのサポート：アルファ、輝度、反転に対応しています
• レイヤーの複製：名前を変更することもできます
• コンポジションからレイヤーを削除
• マスクの作成／変更：ぼかし、拡張、不透明度を設定できます

🌀 アニメーション機能

• レイヤープロパティのキーフレーム設定：位置、スケール、回転、不透明度などに対応しています
• レイヤープロパティへのエクスプレッションの適用：動的なアニメーションを作成できます
• 複数レイヤーのプロパティを一括設定

⚙️ セットアップ手順

🛠 前提条件

• Adobe After Effects（2022 以降）
• Node.js（v14 以降）
• npm または yarn パッケージマネージャー

📥 インストール

1. リポジトリをクローン

   git clone https://github.com/Dakkshin/after-effects-mcp.git
   cd after-effects-mcp
   

2. 依存関係をインストール

   npm install
   # or
   yarn install
   

3. プロジェクトをビルド

   npm run build
   # or
   yarn build
   

4. After Effects パネルをインストール

   npm run install-bridge
   # or
   yarn install-bridge
   

   必要なスクリプトが After Effects のインストール先にコピーされます。

🔧 MCP 設定の更新

方法 1：.mcp.json を使用（Claude Code に推奨）

このリポジトリには、簡単に設定できる .mcp.json ファイルが含まれています。これをコピーするか、MCP 設定で参照してください。

{
  "mcpServers": {
    "AfterEffectsMCP": {
      "command": "node",
      "args": ["PATH/TO/after-effects-mcp/build/index.js"]
    }
  }
}

方法 2：手動設定

クライアント（Claude や Cursor など）で設定ファイルを開き、更新してください。

{
  "mcpServers": {
    "AfterEffectsMCP": {
      "command": "node",
      "args": ["C:\\Users\\Dakkshin\\after-effects-mcp\\build\\index.js"]
    }
  }
}

▶️ サーバーの実行

1. MCP サーバーを起動

   npm start
   # or
   yarn start
   

2. After Effects を開く

3. MCP Bridge Auto パネルを開く

   • After Effects で「ウィンドウ」>「mcp-bridge-auto.jsx」を選択します
   • パネルは数秒ごとにコマンドを自動で確認します
   • 「Auto-run commands」チェックボックスが有効になっていることを確認してください

🚀 使用ガイド

サーバーを起動し、After Effects で MCP Bridge パネルを開くと、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	新しいコンポジションを作成します
run-script	AE 内で JS スクリプトを実行します
get-results	スクリプトの結果を取得します
get-help	利用可能なコマンドのヘルプを表示します
setLayerKeyframe	レイヤーのプロパティにキーフレームを追加します
setLayerExpression	プロパティのエクスプレッションを追加／削除します
setLayerProperties	レイヤーのプロパティ（位置、スケール、回転、不透明度、blendMode、threeDLayer、trackMatteType、enabled など）を設定します
batchSetLayerProperties	複数のレイヤーにプロパティを適用します
getLayerInfo	レイヤー情報（位置、3D 状態）を取得します
createCamera	カメラレイヤーを作成します
createNullObject	アニメーション用のヌルオブジェクトを作成します
duplicateLayer	レイヤーを複製します
deleteLayer	レイヤーを削除します
setLayerMask	レイヤーマスクを作成／編集します

👨‍💻 開発者向け

🧩 プロジェクト構成

• src/index.ts：MCP サーバーの実装
• src/scripts/mcp-bridge-auto.jsx：After Effects のメインパネルスクリプト
• install-bridge.js：After Effects にパネルをインストールするスクリプト

📦 プロジェクトのビルド

npm run build
# or
yarn build

注： このプロジェクトではビルドを高速化するために esbuild を使用しています。大規模なコードベースでメモリ不足になることがあった従来の TypeScript コンパイラー方式に代わるものです。

🤝 コントリビューション

コントリビューションを歓迎します。お気軽に Pull Request を送信してください。

Star History

ライセンス

このプロジェクトは MIT ライセンスのもとでライセンスされています。詳細については LICENSE ファイルをご覧ください。