MCP-アフターエフェクト

🎬 After Effects MCP サーバー

✨ AI アシスタントやその他のアプリケーションが標準化されたプロトコルを通じて After Effects を制御できるようにする、Adobe After Effects 用の Model Context Protocol (MCP) サーバー。

📦 機能

🎥 コア構成機能

カスタム設定（サイズ、フレームレート、継続時間、背景色）でコンポジションを作成します
プロジェクト内のすべてのコンポジションを一覧表示する
フレームレート、寸法、期間などのプロジェクト情報を取得します

🧱 レイヤー管理

カスタマイズ可能なプロパティ（フォント、サイズ、色、位置）を持つテキストレイヤーを作成します
色とストロークを使ってシェイプレイヤー（長方形、楕円、多角形、星形）を作成します
背景やエフェクト用のソリッド/調整レイヤーを作成する
位置、スケール、回転、不透明度、タイミングなどのレイヤープロパティを変更します

🌀 アニメーション機能

レイヤープロパティのキーフレームを設定する（位置、スケール、回転、不透明度など）
ダイナミックアニメーションのレイヤープロパティにエクスプレッションを適用する

⚙️ セットアップ手順

🛠 前提条件

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

📥 インストール

リポジトリをクローンする
git clone https://github.com/yourusername/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
After Effectsを開く
MCP Bridge Autoパネルを開く
- After Effectsで、ウィンドウ > mcp-bridge-auto.jsxに移動します。
- パネルは数秒ごとにコマンドを自動的にチェックします
- 「コマンドの自動実行」チェックボックスが有効になっていることを確認してください

🚀 使用ガイド

サーバーを起動し、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`	新しいコンポジションを作成する
`スクリプトを実行`	AE内でJSスクリプトを実行する
`結果を取得`	スクリプトの結果を取得する
`get-help`	利用可能なコマンドのヘルプ
`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 ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。

mcp-after-effects

Integrations