@synthetic-ai/premiere-mcp 2.0.0

package/dist/tools/workspace.d.ts

@@ -0,0 +1,25 @@
+import { BridgeOptions } from "../bridge/file-bridge.js";
+export declare function getWorkspaceTools(bridgeOptions: BridgeOptions): {
+    get_workspaces: {
+        description: string;
+        parameters: {};
+        handler: () => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    set_workspace: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                name: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            name: string;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+};
+//# sourceMappingURL=workspace.d.ts.map

package/dist/tools/workspace.js

@@ -0,0 +1,61 @@
+import { buildToolScript, escapeForExtendScript } from "../bridge/script-builder.js";
+import { sendCommand } from "../bridge/file-bridge.js";
+export function getWorkspaceTools(bridgeOptions) {
+    return {
+        get_workspaces: {
+            description: "List all available workspace layouts in Premiere Pro",
+            parameters: {},
+            handler: async () => {
+                const script = buildToolScript(`
+          var list = [];
+          try {
+            if (typeof app.getWorkspaces === "function") {
+              var workspaces = app.getWorkspaces();
+              if (workspaces) {
+                for (var i = 0; i < workspaces.length; i++) {
+                  list.push(workspaces[i]);
+                }
+                return __result({ workspaces: list, count: list.length });
+              }
+            }
+          } catch (e) {}
+          return __result({
+            workspaces: list,
+            count: 0,
+            note: "Workspace enumeration is not available in this Premiere Pro version (app.getWorkspaces is undocumented and unsupported here)."
+          });
+        `);
+                return sendCommand(script, bridgeOptions);
+            },
+        },
+        set_workspace: {
+            description: "Switch to a specific workspace layout (e.g., 'Editing', 'Color', 'Audio', 'Effects', 'Graphics')",
+            parameters: {
+                type: "object",
+                properties: {
+                    name: {
+                        type: "string",
+                        description: "Name of the workspace to activate (use get_workspaces to see available options)",
+                    },
+                },
+                required: ["name"],
+            },
+            handler: async (args) => {
+                const script = buildToolScript(`
+          try {
+            if (typeof app.setWorkspace !== "function") {
+              return __error("Setting the workspace is not available in this Premiere Pro version (app.setWorkspace is undocumented and unsupported here).");
+            }
+            var result = app.setWorkspace("${escapeForExtendScript(args.name)}");
+            if (result === false) return __error("Failed to set workspace: ${escapeForExtendScript(args.name)}");
+            return __result({ set: true, workspace: "${escapeForExtendScript(args.name)}" });
+          } catch (e) {
+            return __error("Failed to set workspace '${escapeForExtendScript(args.name)}': " + (e && e.message ? e.message : e));
+          }
+        `);
+                return sendCommand(script, bridgeOptions);
+            },
+        },
+    };
+}
+//# sourceMappingURL=workspace.js.map

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@synthetic-ai/premiere-mcp",
+  "version": "2.0.0",
+  "description": "MCP server for controlling Adobe Premiere Pro via CEP/ExtendScript — 437 tools for AI-driven video editing",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "premiere-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "cep-plugin",
+    "scripts",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "start:http": "node dist/http-server.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "install-cep": "bash scripts/install-cep.sh"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/matiasEltrece/premiere-pro-mcp.git"
+  },
+  "homepage": "https://synthetic.com.ar",
+  "bugs": {
+    "url": "https://synthetic.com.ar"
+  },
+  "author": "Synthetic",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "adobe",
+    "premiere-pro",
+    "video-editing",
+    "ai",
+    "extendscript",
+    "cep",
+    "claude",
+    "windsurf",
+    "cursor",
+    "automation"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "javascript-obfuscator": "^4.2.2",
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.18"
+  }
+}

package/scripts/build-chat-dmg.sh

@@ -0,0 +1,210 @@
+#!/usr/bin/env bash
+# Build a macOS DMG for the Premiere Pro AI Chat plugin.
+# The DMG contains the plugin folder + an installer script.
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+PLUGIN_SRC="$PROJECT_ROOT/chat-plugin"
+BUILD_DIR="$PROJECT_ROOT/build"
+DMG_NAME="Premiere-Pro-AI-Chat"
+DMG_VOLUME="Premiere Pro AI Chat"
+VERSION="1.0.0"
+
+echo "========================================"
+echo "  Building DMG: $DMG_NAME v$VERSION"
+echo "========================================"
+echo ""
+
+# Clean previous DMG staging (preserve other build artifacts)
+rm -rf "$BUILD_DIR/dmg-staging"
+mkdir -p "$BUILD_DIR/dmg-staging"
+
+STAGING="$BUILD_DIR/dmg-staging"
+
+# ---- Copy plugin files ----
+echo "Copying plugin files..."
+mkdir -p "$STAGING/Premiere Pro AI Chat.cep"
+cp -R "$PLUGIN_SRC/"* "$STAGING/Premiere Pro AI Chat.cep/"
+echo "✓ Plugin files copied"
+
+# ---- Create installer script inside DMG ----
+cat > "$STAGING/Install Plugin.command" << 'INSTALLER_EOF'
+#!/usr/bin/env bash
+# Premiere Pro AI Chat — One-click Installer
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PLUGIN_NAME="com.ppro.ai.chat"
+PLUGIN_SRC="$SCRIPT_DIR/Premiere Pro AI Chat.cep"
+CEP_DIR="$HOME/Library/Application Support/Adobe/CEP/extensions"
+
+echo ""
+echo "╔══════════════════════════════════════════╗"
+echo "║   Premiere Pro AI Chat — Installer       ║"
+echo "╚══════════════════════════════════════════╝"
+echo ""
+
+# Verify source
+if [ ! -d "$PLUGIN_SRC" ]; then
+  echo "✗ Error: Plugin files not found."
+  echo "  Make sure you're running this from the DMG."
+  exit 1
+fi
+
+# Create CEP directory
+mkdir -p "$CEP_DIR"
+
+# Remove old installation
+if [ -d "$CEP_DIR/$PLUGIN_NAME" ] || [ -L "$CEP_DIR/$PLUGIN_NAME" ]; then
+  echo "Removing previous installation..."
+  rm -rf "$CEP_DIR/$PLUGIN_NAME"
+fi
+
+# Copy plugin
+echo "Installing plugin..."
+cp -R "$PLUGIN_SRC" "$CEP_DIR/$PLUGIN_NAME"
+echo "✓ Plugin installed to: $CEP_DIR/$PLUGIN_NAME"
+
+# Enable unsigned extensions
+echo "Enabling unsigned CEP extensions..."
+for ver in 9 10 11 12; do
+  defaults write com.adobe.CSXS.$ver PlayerDebugMode 1 2>/dev/null || true
+done
+echo "✓ Debug mode enabled"
+
+echo ""
+echo "════════════════════════════════════════════"
+echo "  ✓ Installation complete!"
+echo ""
+echo "  Next steps:"
+echo "    1. Restart Premiere Pro (if running)"
+echo "    2. Go to: Window → Extensions → AI Chat"
+echo "    3. Enter your Claude or Gemini API key"
+echo "    4. Start chatting!"
+echo "════════════════════════════════════════════"
+echo ""
+echo "Press any key to close..."
+read -n 1 -s
+INSTALLER_EOF
+
+chmod +x "$STAGING/Install Plugin.command"
+echo "✓ Installer script created"
+
+# ---- Create README ----
+cat > "$STAGING/README.txt" << 'README_EOF'
+Premiere Pro AI Chat Plugin
+============================
+
+An embedded AI chat panel for Adobe Premiere Pro.
+Control your edits with natural language using Claude or Gemini.
+
+INSTALLATION
+============
+
+Option 1: Double-click "Install Plugin.command"
+  - This will copy the plugin to your Adobe CEP extensions folder
+  - It will enable unsigned extensions automatically
+
+Option 2: Manual Install
+  - Copy the "Premiere Pro AI Chat.cep" folder to:
+    ~/Library/Application Support/Adobe/CEP/extensions/com.ppro.ai.chat
+  - Enable unsigned extensions by running in Terminal:
+    defaults write com.adobe.CSXS.11 PlayerDebugMode 1
+
+USAGE
+=====
+
+1. Open Premiere Pro
+2. Go to: Window → Extensions → AI Chat
+3. Choose Claude or Gemini as your AI provider
+4. Enter your API key
+5. Start chatting! The AI can:
+   - Query your project (clips, sequences, tracks)
+   - Edit your timeline (add clips, effects, transitions)
+   - Export sequences
+   - And much more
+
+REQUIREMENTS
+============
+
+- macOS 10.14+
+- Adobe Premiere Pro 2020 (v14.0) or later
+- Claude API key (console.anthropic.com) or
+  Gemini API key (aistudio.google.com)
+
+SUPPORT
+=======
+
+GitHub: https://github.com/ppmcp/premiere-pro-mcp
+Issues: https://github.com/ppmcp/premiere-pro-mcp/issues
+README_EOF
+
+echo "✓ README created"
+
+# ---- Create Uninstaller ----
+cat > "$STAGING/Uninstall Plugin.command" << 'UNINSTALL_EOF'
+#!/usr/bin/env bash
+set -e
+
+PLUGIN_NAME="com.ppro.ai.chat"
+CEP_DIR="$HOME/Library/Application Support/Adobe/CEP/extensions"
+
+echo ""
+echo "Uninstalling Premiere Pro AI Chat..."
+
+if [ -d "$CEP_DIR/$PLUGIN_NAME" ] || [ -L "$CEP_DIR/$PLUGIN_NAME" ]; then
+  rm -rf "$CEP_DIR/$PLUGIN_NAME"
+  echo "✓ Plugin removed."
+else
+  echo "Plugin not found — nothing to remove."
+fi
+
+echo ""
+echo "Press any key to close..."
+read -n 1 -s
+UNINSTALL_EOF
+
+chmod +x "$STAGING/Uninstall Plugin.command"
+echo "✓ Uninstaller created"
+
+# ---- Build DMG ----
+echo ""
+echo "Building DMG..."
+
+DMG_PATH="$BUILD_DIR/$DMG_NAME-v$VERSION.dmg"
+TEMP_DMG="$BUILD_DIR/temp.dmg"
+
+# Create a temporary DMG
+hdiutil create -srcfolder "$STAGING" \
+  -volname "$DMG_VOLUME" \
+  -format UDRW \
+  -fs HFS+ \
+  -size 20m \
+  "$TEMP_DMG" \
+  -quiet
+
+# Convert to compressed read-only DMG
+hdiutil convert "$TEMP_DMG" \
+  -format UDZO \
+  -imagekey zlib-level=9 \
+  -o "$DMG_PATH" \
+  -quiet
+
+rm -f "$TEMP_DMG"
+
+echo "✓ DMG built: $DMG_PATH"
+
+# Get file size
+DMG_SIZE=$(du -h "$DMG_PATH" | cut -f1 | xargs)
+
+echo ""
+echo "========================================"
+echo "  ✓ Build complete!"
+echo ""
+echo "  File: $DMG_PATH"
+echo "  Size: $DMG_SIZE"
+echo "========================================"
+echo ""

package/scripts/build-chat-zip.sh

@@ -0,0 +1,291 @@
+#!/usr/bin/env bash
+# Build a cross-platform ZIP for the Premiere Pro AI Chat plugin.
+# The ZIP contains the plugin folder + installers for macOS and Windows.
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+PLUGIN_SRC="$PROJECT_ROOT/chat-plugin"
+BUILD_DIR="$PROJECT_ROOT/build"
+ZIP_NAME="Premiere-Pro-AI-Chat"
+VERSION="1.0.0"
+
+echo "========================================"
+echo "  Building ZIP: $ZIP_NAME v$VERSION"
+echo "========================================"
+echo ""
+
+# Clean previous build
+rm -rf "$BUILD_DIR/zip-staging"
+mkdir -p "$BUILD_DIR/zip-staging"
+
+STAGING="$BUILD_DIR/zip-staging/$ZIP_NAME-v$VERSION"
+mkdir -p "$STAGING"
+
+# ---- Copy plugin files ----
+echo "Copying plugin files..."
+mkdir -p "$STAGING/com.ppro.ai.chat"
+cp -R "$PLUGIN_SRC/"* "$STAGING/com.ppro.ai.chat/"
+echo "✓ Plugin files copied"
+
+# ---- Create Windows installer (.bat) ----
+cat > "$STAGING/Install-Windows.bat" << 'BAT_EOF'
+@echo off
+REM Premiere Pro AI Chat — Windows Installer
+
+setlocal enabledelayedexpansion
+
+echo.
+echo ==========================================
+echo   Premiere Pro AI Chat - Windows Installer
+echo ==========================================
+echo.
+
+set "SCRIPT_DIR=%~dp0"
+set "PLUGIN_SRC=%SCRIPT_DIR%com.ppro.ai.chat"
+set "PLUGIN_NAME=com.ppro.ai.chat"
+set "CEP_DIR=%APPDATA%\Adobe\CEP\extensions"
+
+if not exist "%PLUGIN_SRC%" (
+    echo [ERROR] Plugin files not found.
+    echo Make sure you extracted the ZIP first.
+    pause
+    exit /b 1
+)
+
+REM Create CEP directory
+if not exist "%CEP_DIR%" mkdir "%CEP_DIR%"
+
+REM Remove old installation
+if exist "%CEP_DIR%\%PLUGIN_NAME%" (
+    echo Removing previous installation...
+    rmdir /s /q "%CEP_DIR%\%PLUGIN_NAME%"
+)
+
+REM Copy plugin
+echo Installing plugin...
+xcopy /s /e /i /q "%PLUGIN_SRC%" "%CEP_DIR%\%PLUGIN_NAME%"
+echo [OK] Plugin installed to: %CEP_DIR%\%PLUGIN_NAME%
+
+REM Enable unsigned extensions (CSXS 9-12)
+echo Enabling unsigned CEP extensions...
+for %%v in (9 10 11 12) do (
+    reg add "HKCU\SOFTWARE\Adobe\CSXS.%%v" /v PlayerDebugMode /t REG_SZ /d 1 /f >nul 2>&1
+)
+echo [OK] Debug mode enabled
+
+echo.
+echo ==========================================
+echo   [OK] Installation complete!
+echo.
+echo   Next steps:
+echo     1. Restart Premiere Pro (if running)
+echo     2. Go to: Window ^> Extensions ^> AI Chat
+echo     3. Enter your Claude or Gemini API key
+echo     4. Start chatting!
+echo ==========================================
+echo.
+pause
+BAT_EOF
+
+echo "✓ Windows installer created"
+
+# ---- Create Windows uninstaller (.bat) ----
+cat > "$STAGING/Uninstall-Windows.bat" << 'UNBAT_EOF'
+@echo off
+REM Premiere Pro AI Chat — Windows Uninstaller
+
+set "PLUGIN_NAME=com.ppro.ai.chat"
+set "CEP_DIR=%APPDATA%\Adobe\CEP\extensions"
+
+echo.
+echo Uninstalling Premiere Pro AI Chat...
+
+if exist "%CEP_DIR%\%PLUGIN_NAME%" (
+    rmdir /s /q "%CEP_DIR%\%PLUGIN_NAME%"
+    echo [OK] Plugin removed.
+) else (
+    echo Plugin not found - nothing to remove.
+)
+
+echo.
+pause
+UNBAT_EOF
+
+echo "✓ Windows uninstaller created"
+
+# ---- Create macOS installer (.command) ----
+cat > "$STAGING/Install-macOS.command" << 'MAC_EOF'
+#!/usr/bin/env bash
+# Premiere Pro AI Chat — macOS Installer
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PLUGIN_NAME="com.ppro.ai.chat"
+PLUGIN_SRC="$SCRIPT_DIR/com.ppro.ai.chat"
+CEP_DIR="$HOME/Library/Application Support/Adobe/CEP/extensions"
+
+echo ""
+echo "╔══════════════════════════════════════════╗"
+echo "║   Premiere Pro AI Chat — Installer       ║"
+echo "╚══════════════════════════════════════════╝"
+echo ""
+
+if [ ! -d "$PLUGIN_SRC" ]; then
+  echo "✗ Error: Plugin files not found."
+  exit 1
+fi
+
+mkdir -p "$CEP_DIR"
+
+if [ -d "$CEP_DIR/$PLUGIN_NAME" ] || [ -L "$CEP_DIR/$PLUGIN_NAME" ]; then
+  echo "Removing previous installation..."
+  rm -rf "$CEP_DIR/$PLUGIN_NAME"
+fi
+
+echo "Installing plugin..."
+cp -R "$PLUGIN_SRC" "$CEP_DIR/$PLUGIN_NAME"
+echo "✓ Plugin installed to: $CEP_DIR/$PLUGIN_NAME"
+
+echo "Enabling unsigned CEP extensions..."
+for ver in 9 10 11 12; do
+  defaults write com.adobe.CSXS.$ver PlayerDebugMode 1 2>/dev/null || true
+done
+echo "✓ Debug mode enabled"
+
+echo ""
+echo "════════════════════════════════════════════"
+echo "  ✓ Installation complete!"
+echo ""
+echo "  Next steps:"
+echo "    1. Restart Premiere Pro (if running)"
+echo "    2. Go to: Window → Extensions → AI Chat"
+echo "    3. Enter your Claude or Gemini API key"
+echo "    4. Start chatting!"
+echo "════════════════════════════════════════════"
+echo ""
+echo "Press any key to close..."
+read -n 1 -s
+MAC_EOF
+
+chmod +x "$STAGING/Install-macOS.command"
+echo "✓ macOS installer created"
+
+# ---- Create macOS uninstaller ----
+cat > "$STAGING/Uninstall-macOS.command" << 'UNMAC_EOF'
+#!/usr/bin/env bash
+set -e
+
+PLUGIN_NAME="com.ppro.ai.chat"
+CEP_DIR="$HOME/Library/Application Support/Adobe/CEP/extensions"
+
+echo ""
+echo "Uninstalling Premiere Pro AI Chat..."
+
+if [ -d "$CEP_DIR/$PLUGIN_NAME" ] || [ -L "$CEP_DIR/$PLUGIN_NAME" ]; then
+  rm -rf "$CEP_DIR/$PLUGIN_NAME"
+  echo "✓ Plugin removed."
+else
+  echo "Plugin not found — nothing to remove."
+fi
+
+echo ""
+echo "Press any key to close..."
+read -n 1 -s
+UNMAC_EOF
+
+chmod +x "$STAGING/Uninstall-macOS.command"
+echo "✓ macOS uninstaller created"
+
+# ---- Create README ----
+cat > "$STAGING/README.txt" << 'README_EOF'
+Premiere Pro AI Chat Plugin
+============================
+
+An embedded AI chat panel for Adobe Premiere Pro.
+Control your edits with natural language using Claude or Gemini.
+
+INSTALLATION
+============
+
+Windows:
+  1. Extract this ZIP file
+  2. Right-click "Install-Windows.bat" → Run as administrator
+  3. Restart Premiere Pro
+  4. Go to: Window → Extensions → AI Chat
+
+macOS:
+  1. Extract this ZIP file
+  2. Double-click "Install-macOS.command"
+  3. Restart Premiere Pro
+  4. Go to: Window → Extensions → AI Chat
+
+Manual Install (any OS):
+  - Copy the "com.ppro.ai.chat" folder to your CEP extensions folder:
+    Windows: %APPDATA%\Adobe\CEP\extensions\
+    macOS:   ~/Library/Application Support/Adobe/CEP/extensions/
+  - Enable unsigned extensions:
+    Windows: Set registry key HKCU\SOFTWARE\Adobe\CSXS.11 → PlayerDebugMode = "1"
+    macOS:   Run: defaults write com.adobe.CSXS.11 PlayerDebugMode 1
+
+UNINSTALL
+=========
+
+Windows: Run "Uninstall-Windows.bat"
+macOS:   Double-click "Uninstall-macOS.command"
+
+USAGE
+=====
+
+1. Open Premiere Pro
+2. Go to: Window → Extensions → AI Chat
+3. Choose Claude or Gemini as your AI provider
+4. Enter your API key
+5. Start chatting! The AI can:
+   - Query your project (clips, sequences, tracks)
+   - Edit your timeline (add clips, effects, transitions)
+   - Export sequences
+   - And much more
+
+REQUIREMENTS
+============
+
+- Windows 10+ or macOS 10.14+
+- Adobe Premiere Pro 2020 (v14.0) or later
+- Claude API key (console.anthropic.com) or
+  Gemini API key (aistudio.google.com)
+
+SUPPORT
+=======
+
+GitHub: https://github.com/ppmcp/premiere-pro-mcp
+Issues: https://github.com/ppmcp/premiere-pro-mcp/issues
+README_EOF
+
+echo "✓ README created"
+
+# ---- Build ZIP ----
+echo ""
+echo "Building ZIP..."
+
+ZIP_PATH="$BUILD_DIR/$ZIP_NAME-v$VERSION.zip"
+rm -f "$ZIP_PATH"
+
+cd "$BUILD_DIR/zip-staging"
+zip -r -q "$ZIP_PATH" "$ZIP_NAME-v$VERSION/"
+
+ZIP_SIZE=$(du -h "$ZIP_PATH" | cut -f1 | xargs)
+
+echo "✓ ZIP built: $ZIP_PATH"
+
+echo ""
+echo "========================================"
+echo "  ✓ Build complete!"
+echo ""
+echo "  File: $ZIP_PATH"
+echo "  Size: $ZIP_SIZE"
+echo "  Works on: macOS + Windows"
+echo "========================================"
+echo ""