FCPBridge v2.0.0

FCPBridge v2.0.0 — Direct Programmatic Control of Final Cut Pro

Injected dylib + MCP server that gives you full in-process access to Final Cut Pro's 78,000+ ObjC classes via JSON-RPC and Claude Code.

Quick Start

1. Download FCPBridgePatcher-v2.0.0.zip below
2. Unzip and open FCPBridgePatcher.app
3. Click "Patch Final Cut Pro"
4. Launch the modded FCP from the patcher

The patcher copies FCP to ~/Desktop/FinalCutPro_Modded/, builds the bridge dylib from source, injects it, and re-signs everything. Your original FCP is untouched.

What You Get

• 28 MCP tools for Claude Code integration (blade, markers, transitions, color correction, speed, titles, effects, FCPXML, and more)
• 40+ timeline actions callable programmatically (no AppleScript, no UI automation)
• JSON-RPC server on 127.0.0.1:9876 for any client
• Object handle system for chaining deep ObjC method calls
• KVC property access for reading/writing any property on any object
• FCPXML generation & import without restart (rational time, DTD-ordered)
• Batch operations for multi-step editing sequences
• Timeline analysis with pacing detection and flash frame warnings

MCP Setup

Add to your .mcp.json:

{
  "mcpServers": {
    "fcpbridge": {
      "command": "python3",
      "args": ["/path/to/FCPBridge/mcp/server.py"]
    }
  }
}

Requires Python 3 with the mcp package (pip install mcp).

Requirements

• macOS 14+
• Final Cut Pro (from Mac App Store)
• Xcode Command Line Tools (xcode-select --install)
• ~7 GB free disk space

Patcher App

The patcher is signed and notarized with Developer ID. It handles:

• Copying FCP to a writable location
• Compiling the FCPBridge dylib (universal arm64 + x86_64)
• Injecting LC_LOAD_DYLIB into the Mach-O binary
• Re-signing with custom entitlements (no sandbox)
• Patching CloudContent/ImagePlayground crash points
• Setting up MCP server config

All 30 Tests Pass

Blade, undo/redo, markers (standard + chapter), transitions, playback (play/pause/step/navigate), color correction, retiming, titles, select/deselect, edit navigation, handle chains, KVC property access, effect inspection, timeline analysis, FCPXML generation — all verified programmatically.