AE-MCP

概要

AE-MCPは、ClaudeなどのAIアシスタントがAdobe After Effectsを直接制御できるようにする包括的なMCPサーバーです。コンポジションの作成からプロフェッショナルなエフェクトやエクスプレッションの適用まで、モーショングラフィックスの全ワークフローをカバーする70以上のツールを提供します。

主な機能

Related MCP server: AE MCP Server

要件

• Adobe After Effects 2024 以降

• Node.js 18以上

• macOS または Windows

インストール

ステップ1：MCPサーバーをインストール

git clone https://github.com/anthropics/ae-mcp.git
cd ae-mcp
npm install
npm run build

ステップ2：CEPエクステンションをインストール

macOS：

./scripts/install-cep.sh

Windows：

scripts\install-cep.bat

ステップ3：AIアシスタントを設定

設定ファイルに追加：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "ae-mcp": {
      "command": "node",
      "args": ["/path/to/ae-mcp/dist/index.js"]
    }
  }
}

MCP設定に追加（~/.claude/settings.json）：

{
  "mcpServers": {
    "ae-mcp": {
      "command": "node",
      "args": ["/path/to/ae-mcp/dist/index.js"]
    }
  }
}

ボーナス： このリポジトリには、After Effectsの自動化を強化するClaude Codeスキルが含まれています。スキルファイルをClaude Codeのスキルディレクトリにコピーしてください：

cp -r SKILL/* ~/.claude/skills/

Claude Codeスキルは、After Effectsのワークフロー、プロパティ形式、ベストプラクティスに関する専門知識を提供します。詳細はSKILL/SKILL.mdを参照してください。

ステップ4：After Effectsを起動

1. After Effects 2024以上を起動

2. ウィンドウ > エクステンション > AE-MCP を開く

3. パネルが自動起動し、コマンドの待機を開始します

ツールカテゴリ

プロジェクトとコンポジション

create_project · open_project · save_project · close_project · get_project_info · import_footage · create_composition · modify_composition · duplicate_composition · delete_composition · list_compositions · get_composition_info

レイヤー作成

add_solid_layer · add_text_layer · add_text_layer_advanced · add_shape_layer · add_null_layer · add_adjustment_layer · add_camera_layer · add_light_layer · add_av_layer · precompose_layers · modify_layer · delete_layer

アニメーションとキーフレーム

set_keyframe · set_keyframe_advanced · apply_easy_ease · set_temporal_ease · offset_keyframes · scale_keyframe_timing · reverse_keyframes · copy_keyframes · get_keyframes

エクスプレッション

set_expression · get_expression · remove_expression · enable_expression · add_expression_control · apply_expression_template · link_properties

エフェクト

apply_effect · apply_effect_template · modify_effect_properties · remove_effect · reorder_effects · copy_effects · list_effects

モーショングラフィックステンプレート

アセット管理

import_folder · replace_footage · organize_project_items · find_missing_footage · collect_files · reduce_project

マーカーとタイムライン

add_composition_marker · add_layer_marker · get_markers · delete_marker · set_work_area

クイック例

アニメーションイントロを作成

Create a 1920x1080 composition called "Intro" at 30fps, 5 seconds.
Add a text layer saying "Welcome" centered on screen.
Apply a slideInUp animation with easy ease.
Add a subtle glow effect.

ローワーサードを構築

Create a modern lower third:
- Name: "Sarah Chen"
- Title: "Lead Designer"
- Blue primary color
- Animate in and out
- 5 second duration

物理ベースのモーションを追加

Add a bounce expression to the position of "Logo" layer.
Set amplitude to 0.15, frequency to 4, decay to 6.

アニメーションプリセット

スプリング物理（Remotionにインスパイア）

モーションプリセット

フェード： fadeIn · fadeOut スライド： slideInLeft · slideInRight · slideInUp · slideInDown · slideOutLeft · slideOutRight · slideOutUp · slideOutDown スケール： scaleIn · scaleOut · scaleInBounce 物理： bounce · elastic · overshoot 回転： spinIn · spinOut

エクスプレッションテンプレート

エフェクトテンプレート

アーキテクチャ

ae-mcp/
├── src/                          # TypeScript source
│   ├── index.ts                  # Entry point
│   ├── stdio-server.ts           # MCP server (70+ tools)
│   ├── ae-integration/
│   │   ├── file-communicator.ts  # File-based IPC
│   │   └── generators/           # ES3 script generators
│   └── presets/                  # Animation, expression, effect presets
├── cep-extension/                # After Effects extension
│   ├── CSXS/manifest.xml
│   ├── jsx/host.jsx              # ExtendScript host
│   └── js/main.js                # Panel JavaScript
├── SKILL/                        # Claude Code skill
│   ├── SKILL.md                  # Skill definition
│   └── examples.md               # Animation examples
└── scripts/                      # Installation scripts

通信フロー

AI Assistant (Claude)
        ↓
   MCP Server (Node.js)
        ↓ Write JSON command
   ~/Documents/ae-mcp-commands/
        ↓ Poll every 100ms
   CEP Extension
        ↓ Execute script
   After Effects DOM
        ↓ Write response
   *.json.response

トラブルシューティング

1. デバッグモードが有効になっていることを確認（インストールスクリプトが自動的に行います）

2. After Effectsを完全に再起動

3. エクステンションの場所を確認：

   • macOS： ~/Library/Application Support/Adobe/CEP/extensions/ae-mcp

   • Windows： %APPDATA%\Adobe\CEP\extensions\ae-mcp

1. After Effects内でAE-MCPパネルが表示されていることを確認

2. ~/Documents/ae-mcp-commands/ にコマンドファイルがあるか確認

3. パネルのログでエラーを確認

1. After EffectsでExtendScriptツールキットまたはコンソールを開く

2. コンポジション/レイヤーの参照が存在することを確認

3. ES3互換性の問題がないか確認（アロー関数、テンプレートリテラルなど）

コントリビューション

コントリビューションを歓迎します！プルリクエストを送る前に、コントリビューションガイドラインをお読みください。

ライセンス

MIT