clipwright-speed

AI-facing MCP tool that applies a LinearTimeWarp speed change to clips in an OpenTimelineIO (OTIO) timeline.

What it does

clipwright_set_speed reads an existing OTIO timeline, attaches (or replaces) a LinearTimeWarp effect on the target clip(s) using the given speed multiplier, and writes the result to a new OTIO file. The input timeline is never modified (non-destructive). Applying the same speed twice replaces rather than stacks the warp (idempotent).

Tool: clipwright_set_speed

Speed range

Valid range is 0.25 to 8.0 inclusive. Values outside this range return an INVALID_INPUT error with a hint.

Idempotency

Applying clipwright_set_speed twice with the same speed on the same clip results in exactly one LinearTimeWarp effect — no stacking.

Non-destructive

The input timeline file is never modified. All changes go to the output path.

Foreign warps

Pre-existing LinearTimeWarp effects that were not created by clipwright-speed (i.e., lacking metadata["clipwright"]) are preserved.

MCP Registration Example

{
  "mcpServers": {
    "clipwright-speed": {
      "command": "clipwright-speed"
    }
  }
}

Or with an explicit Python path:

{
  "mcpServers": {
    "clipwright-speed": {
      "command": "/path/to/.venv/bin/python",
      "args": ["-m", "clipwright_speed.server"]
    }
  }
}

Prerequisites

• Python 3.11+
• opentimelineio 0.18+
• clipwright 0.3.0+ (core package)

License

MIT