内容
# After Effects MCP - 增强多语言版
[](https://github.com/a-y-ibrahim/after-effects-mcp/actions/workflows/ci.yml)
[](LICENSE)
[](https://nodejs.org)
[](https://modelcontextprotocol.io)
> 🌍 **[阿拉伯语 / Arabic README](README.ar.md)**
通过任何 MCP 客户端（Claude Code / Claude Desktop）控制 Adobe After Effects：创建和检查合成和图层，动画，应用效果和预设，管理遮罩/摄像机，**后台渲染**，并运行任意 ExtendScript - 具有 **一流的阿拉伯语 / RTL 支持** 和适用于任何 UI 语言的 After Effects 工具。
这是在原有工作基础上增强的多语言版，由 [**Dakkshin/after-effects-mcp**](https://github.com/Dakkshin/after-effects-mcp) 构建。参见 [CREDITS.md](CREDITS.md)。
---
## ✨ 为什么选择这个版本
| 领域 | 这个版本 |
| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **适用于任何 AE 语言** | 所有标准属性查找使用独立于本地的 `matchName`s → 不会在阿拉伯语/法语/德语/日语 AE 中出现故障 |
| **阿拉伯语 / RTL 文本** | `create-text-layer` 自动检测阿拉伯语，设置从右到左的方向和右对齐 |
| **任意脚本** | `execute-script` 运行任意 ExtendScript → 访问每个 AE 功能 |
| **视觉反馈** | `see-frame` 将帧渲染回图像，以便 AI 可以查看其工作并自我纠正（其他 AE MCP 不具备此功能） |
| **深入检查** | `inspect-comp` / `inspect-layer` - 查看编辑前的确切状态 |
| **渲染** | 应用程序渲染队列 **和** 后台 `aerender`（无 UI 冻结） |
| **可靠性** | 每命令 ID（无过期结果），每个命令一个撤销组，更快的轮询，OneDrive 证明共享文件夹，`check-bridge` 健康/版本检查 |
| **图层管理** | 摄像机，复制，删除，遮罩，批量变换，合成设置 - 作为专用工具 |
**共 47 种工具。** 详细信息请参见 [ENHANCEMENTS.md](ENHANCEMENTS.md)。
---
## 📋 先决条件
- **Adobe After Effects** 2022 或更高版本
- **Windows 或 macOS。** After Effects 本身仅在这些两个平台上运行，因此服务器旨在与 After Effects 在同一台机器上运行。Node 进程在 Linux 上启动，CI 在 Linux 上构建和测试，但没有可驱动的 After Effects。
- **Node.js 18+** - <https://nodejs.org>
- MCP 客户端（例如 **Claude Code**：`npm install -g @anthropic-ai/claude-code`)
## 🚀 安装
```bash
git clone https://github.com/a-y-ibrahim/after-effects-mcp.git
cd after-effects-mcp
npm install # 安装 + 构建
npm run install-bridge # 将面板复制到 AE 的 ScriptUI 面板
```
然后在 After Effects 中：
1. 启用脚本编写 - **Windows**：编辑 > 首选项 > 脚本编写和表达式；**macOS**：After Effects > 设置 > 脚本编写和表达式 → 启用 **“允许脚本写入文件和访问网络”**。
2. 重启 After Effects。
3. **窗口 > mcp-bridge-auto.jsx** - 保持此面板打开。
使用您的 MCP 客户端注册服务器：
```bash
claude mcp add AfterEffectsMCP node /绝对路径/to/after-effects-mcp/build/index.js
```
**第一个测试：** 请您的客户端 _“检查 After Effects 桥”_。它应该报告 `bridgeVersion: 1.7.1-mcp-enhanced` 和 `versionMatch: true`。
> 💡 如果您编辑服务器，请重新运行 `npm run build`，然后重启 MCP 客户端。如果您编辑桥，还请重新运行 `npm run install-bridge` 并重启 After Effects。
---
## 🧰 工具一览
**检查和诊断** - `see-frame`，`contact-sheet`，`match-reference`，`inspect-comp`，`inspect-layer`，`get-results`，`check-bridge`，`run-bridge-test`，`get-help`
**合成和图层** - `create-composition`，`set-composition-properties`，`create-text-layer`，`create-camera`，`create-adjustment-layer`，`duplicate-layer`，`delete-layer`，`center-layers`，`set-layer-mask`，`batch-set-layer-properties`
**动画** - `setLayerKeyframe`，`setLayerExpression`，`get-layer-clip-frames`
**效果** - `apply-effect`，`add-any-effect`，`apply-effect-template`，`list-layer-effects`，`list-available-effects`，`set-effect-property`，`set-effect-keyframe`，`remove-effect`，`mcp_aftereffects_get_effects_help`
**预设** - `list-presets`，`search-presets`，`apply-preset`
**音频和标记** - `get-audio-info`，`set-audio-levels`，`analyze-audio-waveform`，`add-marker`，`add-markers-bulk`
**渲染** - `add-to-render-queue`，`render-queue`，`start-render`，`render-aerender`，`render-status`
**功能** - `execute-script`（任意 ExtendScript），`run-script`，`test-animation`
对于项目/合成概述，您还可以使用 `run-script` 和 `getProjectInfo` / `listCompositions`。
📖 完整参考： [docs/TOOLS.md](docs/TOOLS.md)（所有 47 种工具）· [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)（桥的工作原理）。
---
## 🌙 阿拉伯语 / RTL 示例
> “创建一个文本层，内容为 ‘مرحبا بالعالم’”
`create-text-layer` 检测阿拉伯语并自动设置从右到左的方向和右对齐。使用支持阿拉伯语的字体（例如 `Tahoma`，`Cairo`）。对于完整的阿拉伯语形状，在 After Effects 中启用中东文本引擎（**Windows**：首选项 > 类型；**macOS**：设置 > 类型）。
---
## 🩺 故障排除
- **任何超时 / 奇怪行为** → 首先询问 _“检查 After Effects 桥”_。
- **版本不匹配警告** → 重新运行 `npm run install-bridge`，重启 After Effects。
- **“结果文件似乎已过期”** → 面板未运行或无法写入文件；请重新打开它并确认脚本编写权限。
- **Windows + OneDrive** → 共享文件夹为 `%LOCALAPPDATA%\ae-mcp-bridge`（OneDrive 证明）。如果需要，可以在两侧覆盖 `AE_MCP_BRIDGE_DIR` 环境变量。
---
## 🧪 开发
```bash
npm run build # 编译 + 复制桥脚本
npm run typecheck # tsc --noEmit
npm test # Vitest 单元测试套件
```
纯逻辑存在于 [src/lib/bridge-core.ts](src/lib/bridge-core.ts) 中，并在 [tests/bridge-core.test.ts](tests/bridge-core.test.ts) 中进行单元测试。CI 在 Linux、macOS 和 Windows 上进行类型检查和构建，涵盖 Node 18、20 和 22，并在 Node 20 和 22 上运行测试套件（Vitest 4 需要 Node 20+）。有关架构和如何添加工具的信息，请参见 [CONTRIBUTING.md](CONTRIBUTING.md)。
---
## 📄 致谢和许可证
在 **MIT 许可证** 下获得许可。原始作品 © 2025 Dakkshin；增强多语言版 © 2026 Abdelrahman Youssef。参见 [LICENSE](LICENSE) 和 [CREDITS.md](CREDITS.md)。
