ae mcp插件
Adobe After Effects的Claude代码MCP服务器。允许Claude Code读取AE项目数据、检查层和表达式、执行ExtendScript、验证JSX文件、监视渲染以及跨会话共享状态。
建筑
Claude Code MCP Server (Node.js) CEP Panel (inside AE) ExtendScript
快速开始
1.启用未签名的扩展名
scripts\enable-unsigned.bat
2.将CEP面板安装到After Effects中
scripts\install.bat
3.构建MCP服务器
scripts\build.bat
4.添加到Claude代码配置
添加 ~/.claude.json （或 ~/.claude/.mcp.json):
{
"mcpServers": {
"ae-bridge": {
"command": "node",
"args": ["C:/Users/aliba/Downloads/Apollova/ae-mcp-plugin/packages/mcp-server/dist/index.js"]
}
}
}
5.重新启动After Effects
打开面板： 窗口>扩展>AE MCP桥
当Claude Code连接时，状态点变为绿色。
MCP工具
项目检查
| 工具 | 说明 |
|---|
ae_get_project_info | 项目名称、路径、AE版本、项目计数 |
ae_list_comps | 列出组合（可选正则表达式过滤器） |
ae_search_project | 按名称/类型搜索项目 |
分层检查
| 工具 | 说明 |
|---|
ae_list_layers | 按类型、输入/输出点列出图层 |
ae_get_layer_properties | 转换、源文本、效果、源信息 |
表达
| 工具 | 说明 |
|---|
ae_get_expressions | 获取一个层或整个comp上的所有表达式 |
ae_eval_expression_at_time | 在特定时间评估房产 |
脚本执行
| 工具 | 说明 |
|---|
ae_eval_extendscript | 运行任意ExtendScript代码 |
ae_run_jsx_file | 从磁盘执行JSX文件 |
ae_validate_jsx_file | 语法检查+通过撤消进行可选的模拟运行 |
渲染队列
| 工具 | 说明 |
|---|
ae_get_render_queue | 列出具有状态的渲染队列项 |
ae_monitor_render | 轮询，直到渲染完成或超时 |
ae_check_output | 验证渲染输出文件是否存在 |
跨会话上下文
| 工具 | 说明 |
|---|
ae_read_shared_context | 读取共享状态文件 |
ae_write_shared_context | 写入键值对（文件锁定） |
上下文文件位置： %APPDATA%\Apollova\ae-mcp-context.json
发展
# Install dependencies
npm install
# Run tests
npm test
# Watch mode
cd packages/mcp-server && npx vitest
项目结构
ae-mcp-plugin/
├── packages/
│ ├── mcp-server/ # MCP server (TypeScript)
│ │ ├── src/
│ │ │ ├── index.ts # Entry point (stdio transport)
│ │ │ ├── bridge.ts # WebSocket client to CEP panel
│ │ │ └── tools/ # 13 MCP tool definitions
│ │ └── tests/ # 79 vitest tests
│ └── cep-panel/ # CEP extension (installed into AE)
│ ├── CSXS/manifest.xml # Extension manifest
│ ├── index.html # Panel UI
│ ├── js/ # WebSocket server + dispatcher
│ └── jsx/ # ExtendScript functions
└── scripts/ # Install + build scripts
需求
- 2024年或之后
- Node.js 18+
- Windows（CEP符号链接需要Windows路径）
运作原理
- CEP面板 在AE内部加载并启动WebSocket服务器
127.0.0.1:9741 - MCP服务器 作为Node.js进程运行，由Claude Code通过stdio启动
- 当Claude Code调用工具时（例如。
ae_list_comps)，MCP服务器通过WebSocket向CEP面板发送JSON-RPC请求 - CEP小组呼叫
csInterface.evalScript() 在AE中运行ExtendScript - ExtendScript访问AE DOM（comps、图层、表达式、渲染队列）并返回JSON
- 结果返回：ExtendScript->CEP面板->WebSocket->MCP服务器->Claude代码
