Skip to main content
Glama
README.md
# Roon1e MCP for AE

An MCP server that lets Claude drive **Adobe After Effects**. It installs a dockable panel in After Effects that runs Claude's requests. Each change is one named Undo step, and a **Pause Claude** switch blocks all changes.

- One Python file, standard library only. Nothing to `pip install`.
- No API key and no call limit. Everything runs locally through files in `Documents/ae-mcp-bridge`.
- Works with Claude Code and Claude Desktop, or any MCP client that uses stdio.

## Quick start: let Claude set it up

1. Open **Claude Code**: the `claude` terminal app, or the Code tab in the Claude desktop app.
2. Paste this repo's link and say: **"Set this up for me using SETUP-WITH-CLAUDE.md."**
3. Do the two steps Claude asks you to do inside After Effects.

[SETUP-WITH-CLAUDE.md](SETUP-WITH-CLAUDE.md) holds the full steps Claude follows, plus a troubleshooting table.

## Manual setup

You need After Effects and Python 3.8 or newer. On Windows, use `py -3` wherever this says `python`.

1. Download the repo: **Code > Download ZIP**, or `git clone`. Then run:
   ```
   python roon1e_mcp.py install
   ```
   This copies the panel into each After Effects version it finds. It also copies the script to `Documents/ae-mcp-bridge/roon1e_mcp.py`, and prints the exact paths for step 4.
2. In After Effects, open **Edit > Preferences > Scripting & Expressions** (macOS: **After Effects > Settings**). Tick **Allow Scripts to Write Files and Access Network**.
3. Restart After Effects and open **Window > Roon1e MCP for AE.jsx**. To dock the panel, drag its tab into a panel group.
4. Connect Claude, using the paths that `install` printed.

   **Claude Code**
   ```
   claude mcp add --scope user roon1e -- "<python path>" "<server path>" serve
   ```
   **Claude Desktop**: open **Settings > Developer > Edit Config**, then add:
   ```json
   {
     "mcpServers": {
       "roon1e": { "command": "<python path>", "args": ["<server path>", "serve"] }
     }
   }
   ```
5. Check it with `python "<server path>" status`. It should print `LIVE`.

## Tools

| Tool | What it does |
|---|---|
| `ae_status` | Shows whether the panel is open and listening, plus the open project and active comp. |
| `ae_run_jsx` | Runs ExtendScript as one named Undo step. The code assigns `result` to return data. `label` names the step in the panel feed and the Undo menu. |
| `ae_command` | Runs a built-in command: `createComposition`, `createTextLayer`, `createShapeLayer`, `createSolidLayer`, `createCamera`, `duplicateLayer`, `deleteLayer`, `setLayerMask`, `setLayerProperties`, `batchSetLayerProperties`, `setCompositionProperties`, `setLayerKeyframe`, `setLayerExpression`, `applyEffect`, `applyEffectTemplate`, `getProjectInfo`, `listCompositions`, `getLayerInfo` or `ping`. |

## The panel

- **Status card:** green means ready, amber means working, grey means paused. The **Pause Claude / Let Claude work** switch is remembered between sessions. While the panel is paused, nothing can change the project.
- **Tiles:** Changes, Last active and Hiccups (failed requests).
- **Recent activity:** each change in plain words, newest first.
- **Options:** response speed, **Fix connection**, **Open folder**, and **Show technical details**.

## Command line

```
python roon1e_mcp.py status | ping | install [--dest DIR] | uninstall | serve
python roon1e_mcp.py run <file.jsx|-> [timeout_s] [--label "Added a glow"] [--direct]
python roon1e_mcp.py cmd <command> [json-args]
```

`--direct` skips the panel and runs the script through `AfterFX.exe -r`. It works on Windows only.

## How it works

1. The client writes `ae_command.json` with `{command, args, timestamp, status: "pending"}`.
2. The panel picks up the command, sets the status to `running`, and runs it.
3. The panel writes the result to `ae_mcp_result.json` and sets the status to `completed` or `error`.

The panel also rewrites `heartbeat.json` about once a second. All three files live in `Documents/ae-mcp-bridge`.

**Security:** `ae_run_jsx` runs any ExtendScript that the MCP client sends, with After Effects' file and network access. Connect it only to Claude sessions you trust. Use **Pause Claude** when you don't want any changes.

## Uninstall

1. Run `python "<server path>" uninstall`.
2. Remove the `roon1e` server: run `claude mcp remove roon1e --scope user`, or delete its entry from the Claude Desktop config.

## License

MIT