clipwright-trim

MCP tool for explicit keep/drop range selection and OTIO timeline generation. Accepts user-defined time ranges in seconds and produces a kept-range OTIO timeline that clipwright-render can use for precise, non-destructive video editing.

Overview

• Input: Media file (video or audio), output OTIO path, optional keep/drop range specification
• Process: Validates ranges against media duration (via ffprobe), applies padding, builds a kept-range OTIO timeline using the same structure as clipwright-silence output
• Output: New OTIO file with KEEP intervals; input media is never modified (non-destructive, readOnly)

MCP Tool

clipwright_trim

Parameters

TrimOptions

TrimRange

Return Value

{
  "ok": true,
  "summary": "Kept 2 clip(s) totalling 45.0 s out of 120.0 s source duration (mode: keep).",
  "data": {
    "clip_count": 2,
    "kept_duration_sec": 45.0,
    "source_duration_sec": 120.0,
    "mode": "keep"
  },
  "artifacts": [
    {"role": "timeline", "path": "/path/to/output.otio", "format": "otio"}
  ],
  "warnings": []
}

Requirements

• Python 3.11+
• ffprobe (path resolved via CLIPWRIGHT_FFPROBE environment variable or PATH)
• ffmpeg is not required (this tool produces OTIO only; rendering is clipwright-render's responsibility)

Usage with MCP

Register in your MCP client configuration:

{
  "mcpServers": {
    "clipwright-trim": {
      "command": "clipwright-trim",
      "env": {
        "CLIPWRIGHT_FFPROBE": "/path/to/ffprobe"
      }
    }
  }
}

License

MIT