After Effects MCP スキル

概要

このスキルはMCPツールを通じたAdobe After Effectsの自動化を実現します。プロジェクト管理、コンポジション作成、レイヤー操作、アニメーション、エフェクト、エクスプレッションに対応しています。

クリティカルなプロパティパスの形式

After Effectsのプロパティには正確な命名が必要です。一般的なパターンは以下の通りです：

トランスフォームプロパティ：

• Position: "Position"
• Scale: "Scale"
• Rotation: "Rotation" または "Z Rotation"
• Opacity: "Opacity"
• Anchor Point: "Anchor Point"

テキストプロパティ：

• Source Text: "Source Text"
• テキストアニメーター用: アニメーターコンテキスト内で "Opacity" のような相対パスを使用

シェイプレイヤープロパティ：

• シェイプグループ内のPosition: "Contents.Shape 1.Transform.Position"
• シェイプグループ内のScale: "Contents.Shape 1.Transform.Scale"

エフェクトプロパティ：

• エフェクトパラメータ: "Effects.Gaussian Blur.Blurriness"

プロパティタイプ別の値の形式

異なるプロパティは特定の値形式が必要です：

Position: {"x": 960, "y": 540} または [960, 540] Scale: [100, 100] (パーセンテージ) Rotation: 45 (度) Opacity: 100 (パーセンテージ、0-100) Color (RGB 0-1の範囲): {"r": 1.0, "g": 0.5, "b": 0.0} Source Text: 文字列値

一般的なワークフロー

1. 基本的なアニメーションシーンの作成

1. プロジェクトを作成（オプション：名前を指定）
2. 指定したスペック（幅、高さ、期間、フレームレート）でコンポジションを作成
3. レイヤーを追加（ソリッド、シェイプ、テキスト、AV）
4. 初期プロパティを設定（位置、スケール、不透明度）
5. 異なる時間にキーフレームを追加
6. スムーズなモーションにイージングを適用
7. プロジェクトを保存

2. テキストアニメーションパターン

1. コンテンツでテキストレイヤーを追加
2. テキストプロパティを設定（フォントサイズ、色、位置、配置）
3. create_text_animatorでプリセットアニメーションを使用：
   - typewriter
   - fadeInChars
   - scaleInChars
   - slideInChars
   - randomize
   - wave
4. または手動でテキストプロパティにキーフレームを追加

3. エフェクト適用パターン

1. apply_effectを使用してレイヤーにエフェクトを適用
2. modify_effect_propertiesを使用してエフェクトプロパティを修正
3. またはapply_effect_templateでプリセットエフェクトを使用：
   - gaussianBlur、directionalBlur、glassBlur
   - curves、colorBalance、brightnessContrast、vibrance
   - glow、dropShadow、vignette
   - cinematicLook、vhsRetro、neonGlow、filmGrain
   - chromaticAberration、duotone

4. エクスプレッションベースのアニメーション

1. set_expressionを使用してプロパティにエクスプレッションを設定
2. apply_expression_templateから利用可能な一般的なエクスプレッションテンプレート：
   - wiggle、wiggleSmooth、wiggleFadeIn、wiggleFadeOut
   - loopCycle、loopPingpong、loopOffset、loopContinue
   - time、clock、countdown、frameNumber
   - matchPosition、offsetPosition、inverseRotation
   - followPath、bounce、inertia、overshoot、springy
3. link_propertiesを使用してレイヤー間のプロパティをリンク

キーツールの動作と注意点

キーフレーム設定

set_keyframe - 基本的なキーフレーム設定：

• イージングなしの単純なキーフレームに使用
• 値の形式はプロパティタイプと一致する必要があります
• 時間は秒単位（フレームではなく）

set_keyframe_advanced - イージングコントロール付き：

• inType/outType: LINEAR、BEZIER、HOLD
• inEase/outEase: {speed: number, influence: number}
• スムーズでプロフェッショナルなモーション向け

apply_easy_ease - クイックイージング適用：

• 既存のキーフレームに適用
• Type: IN、OUT、BOTH
• インデックスで特定のキーフレームをターゲットするか、すべてのキーフレームに適用可能

レイヤー参照

レイヤーは以下で識別できます：

• layerName: 明確性のため推奨
• layerIndex: 1ベース（1 = 最上位レイヤー）

レイヤーを修正する際は、list_layersまたはget_layer_infoでレイヤーが存在することを常に確認してください。

コンポジション管理

コンポジションの作成：

• 完全な寸法とタイミングを指定
• backgroundColorは0-1のRGB値を使用
• フレームレート：一般的には24、30、60

コンポジションの修正：

• 作成後、任意のパラメータを変更可能
• 変更はすべてのネストされたインスタンスに影響

シェイプレイヤーの制限事項

シェイプレイヤーは複雑なプロパティ階層を持ちます：

• Contentsグループを通じてナビゲートする必要があります
• トランスフォームプロパティはシェイプグループ内にネストされています
• 最初は非表示のプロパティもあります

シェイプオペレーションが「property is hidden」エラーで失敗する場合、レイヤー構造を手動で調整するか、異なるアプローチが必要な場合があります。

プリビルトテンプレート

ロワーサード (create_lower_third):

• スタイル：modern、corporate、news、minimal、social
• 位置：bottomLeft、bottomRight、bottomCenter
• テキストとアニメーション背景を自動作成

タイトルカード (create_title_card):

• スタイル：cinematic、documentary、social、minimal
• フルスクリーンのアニメーションタイトルシーケンス

トランジション (create_transition):

• タイプ：wipe_left、wipe_right、wipe_up、wipe_down、dissolve、push、slide、zoom
• 期間とイージングはカスタマイズ可能

ロゴリビール (create_logo_reveal):

• インポートされたロゴフッテージが必要
• スタイル：fade、scale、slide、spin、glitch、particle

エクスプレッションのベストプラクティス

1. 可能な限りテンプレートを使用: apply_expression_templateはテスト済みで動作実績のあるエクスプレッションを提供します
2. プロパティ参照: positionではなくthisLayer.transform.positionを使用してください
3. 時間ベース: 継続的なアニメーション用にtime変数を使用
4. 値参照: 現在のプロパティ値を参照するためにvalueを使用

よくあるエラーと解決策

「Property not found」

• プロパティ名のスペルを正確に確認
• プロパティパスに親グループが含まれているかチェック
• get_layer_infoで利用可能なプロパティを確認

「Value is not an array」

• 値の形式がプロパティタイプと一致することを確認
• Scaleは配列が必要: [100, 100]
• Positionはオブジェクトまたは配列を使用可能

「Property is hidden」

• シェイプレイヤープロパティは最初は非表示の場合があります
• 異なるアプローチまたは手動レイヤーセットアップを試してください
• レイヤー作成後にのみアクセス可能なプロパティもあります

「File couldn't be opened for writing」

• 保存操作に絶対パス全体を提供してください
• Mac: /Users/username/path/to/file.aep
• Windows: C:/Users/username/path/to/file.aep

プロジェクト構成のベストプラクティス

1. レイヤー命名: 簡単参照のため説明的な名前を使用
2. プリコンポーズ: 関連するレイヤーをプリコンプにグループ化して整理
3. マーカー: タイミング参照とメモのためにマーカーを追加
4. ワークエリア: 特定のセクションのレンダリングに焦点を当てるためにワークエリアを設定
5. プロジェクト構造: organize_project_itemsを使用してフッテージをフォルダに整理

アニメーションタイミングガイドライン

コンテンツタイプ別の期間：

• UIアニメーション：0.3～0.5秒
• テキストリビール：0.5～1.5秒
• ロゴアニメーション：1～3秒
• フルタイトルカード：3～5秒
• トランジション：0.5～1.5秒

イージング推奨事項：

• 自然なモーション：Easy Ease（両方）
• バウンスィなエントランス：オーバーシュート付きEase Out
• スナッピーなエグジット：Ease In
• 継続的なループ：Linear

よくあるユースケース

ソーシャルメディアグラフィックス

1. 1080x1920（縦向き）または1920x1080（横向き）のコンポジションを作成
2. ブランドカラーとテキストを追加
3. クイックアニメーション（0.3～0.8秒）を使用
4. モダンで大胆なスタイルを適用

コーポレートビデオ

1. 1920x1080のコンポジションを30fpsで作成
2. コーポレート/プロフェッショナルテンプレートを使用
3. より長くスムーズなアニメーション（1～2秒）
4. プロフェッショナルなカラーグレーディングエフェクト

モーショングラフィックスループ

1. プロパティにループエクスプレッションを設定
2. シームレスなループのためにmodulo操作を使用
3. 最初と最後のフレームを一致させる
4. 速度変化のためにタイムリマップを使用

エクスプレイナーアニメーション

1. シーンを順番に構築
2. コールアウト用にテキストアニメーターを使用
3. マーカーとタイミングを調整
4. グループモーション用にレイヤーを親にする

パフォーマンス考慮事項

• 複雑なエクスプレッションはプレビューを遅くする場合があります
• 編集時に必要に応じてエクスプレッションを無効化
• 大量のフッテージにはプロキシを使用
• 可能な限りコンポジション複雑さを削減
• 複雑なセクションを事前レンダリング

統合のヒント

インポートされたフッテージを操作する場合：

1. 単一ファイル用にimport_footageを使用
2. バッチ処理用にimport_folderを使用
3. replace_footageでフッテージアイテムを置き換え
4. find_missing_footageで欠落フッテージを検出
5. 共有前にcollect_filesでファイルを収集

クイックリファレンス：最も使用される関数

必須：

• create_project、save_project
• create_composition
• add_text_layer、add_shape_layer、add_solid_layer
• set_keyframe、apply_easy_ease
• save_project

アニメーション：

• set_keyframe_advanced
• apply_expression_template
• create_text_animator

エフェクト：

• apply_effect_template
• modify_effect_properties

テンプレート：

• create_lower_third
• create_title_card
• create_transition

整理：

• list_compositions、list_layers
• get_composition_info、get_layer_info
• precompose_layers