davinci-resolve-mcp 2.143.0 → 2.144.0

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 Release history for the DaVinci Resolve MCP Server. The latest release is summarized in the root README; older entries live here to keep the README focused.
 
+## What's New in v2.144.0 — turnover clip markers ride the items
+
+### Added
+
+- **OTIO clip markers and FCP7-XMEML clipitem `<marker>`s route to ITEM
+  markers** on their cuts through `assemble_from_interchange` (frames
+  clip-relative, colors mapped, notes preserved; markers on trimmed-away
+  material drop rather than refuse). Track-level markers still author as
+  timeline markers. Built on v2.143's `Sm2TiItemLockableBlob` authoring —
+  the only .drt carrier for clip markers, since Resolve's own exporter
+  drops them.
+
 ## What's New in v2.143.0 — item markers, and two refinements
 
 ### Added

package/README.md

@@ -2,7 +2,7 @@
 
 English | [简体中文](README.zh-CN.md)
 
-[![Version](https://img.shields.io/badge/version-2.143.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-2.144.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
 [![npm](https://img.shields.io/npm/v/davinci-resolve-mcp.svg?label=npm&color=CB3837)](https://www.npmjs.com/package/davinci-resolve-mcp)
 [![API Coverage](https://img.shields.io/badge/API%20Coverage-100%25-brightgreen.svg)](docs/reference/api-coverage.md)
 [![Tools](https://img.shields.io/badge/MCP%20Tools-36%20(353%20full)-blue.svg)](#server-modes)

package/README.zh-CN.md

@@ -2,7 +2,7 @@
 
 [English](README.md) | 简体中文
 
-[![Version](https://img.shields.io/badge/version-2.143.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-2.144.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
 [![npm](https://img.shields.io/npm/v/davinci-resolve-mcp.svg?label=npm&color=CB3837)](https://www.npmjs.com/package/davinci-resolve-mcp)
 [![API Coverage](https://img.shields.io/badge/API%20Coverage-100%25-brightgreen.svg)](docs/reference/api-coverage.md)
 [![Tools](https://img.shields.io/badge/MCP%20Tools-36%20(353%20full)-blue.svg)](#服务器模式)
@@ -12,7 +12,7 @@
 [![Python](https://img.shields.io/badge/python-3.10+-green.svg)](https://www.python.org/downloads/)
 [![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
-> 本翻译对应 v2.143.0 版 README。如与英文原版有出入，以 [英文原版](README.md) 为准。
+> 本翻译对应 v2.144.0 版 README。如与英文原版有出入，以 [英文原版](README.md) 为准。
 
 一个 Model Context Protocol (MCP) 服务器，让 AI 助手通过官方脚本 API 控制 DaVinci Resolve Studio（达芬奇）。它提供完整的 API 覆盖，外加带护栏的工作流助手，涵盖剪辑、媒体池整理、渲染设置、审阅标记、调色、Fusion、Fairlight、项目生命周期任务、扩展开发，以及不碰源媒体的媒体分析。
 

package/install.py

@@ -37,7 +37,7 @@ from src.utils.update_check import (
 
 # ─── Version ──────────────────────────────────────────────────────────────────
 
-VERSION = "2.143.0"
+VERSION = "2.144.0"
 # Only hard floor: mcp[cli] requires Python 3.10+. There is no upper bound —
 # Resolve's scripting bridge loads into newer interpreters on recent builds
 # (Python 3.14 verified against Resolve Studio 20.3.2). Older Resolve builds

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "davinci-resolve-mcp",
-  "version": "2.143.0",
+  "version": "2.144.0",
   "description": "NPM bootstrapper for the DaVinci Resolve MCP Server.",
   "license": "MIT",
   "author": "Samuel Gursky <samgursky@gmail.com>",

package/resolve-advanced/server/author-interchange.mjs

@@ -10,6 +10,14 @@
  */
 import { drt } from './libs.mjs';
 
+const COLOR_MAP = {
+  blue: 'Blue', cyan: 'Cyan', green: 'Green', yellow: 'Yellow', red: 'Red',
+  pink: 'Pink', purple: 'Purple', magenta: 'Fuchsia', fuchsia: 'Fuchsia',
+  rose: 'Rose', lavender: 'Lavender', sky: 'Sky', mint: 'Mint',
+  lemon: 'Lemon', sand: 'Sand', cocoa: 'Cocoa', cream: 'Cream',
+  orange: 'Sand', white: 'Cream', black: 'Cocoa',
+};
+
 const pad = (n, w = 2) => String(Math.max(0, Math.floor(n))).padStart(w, '0');
 
 /** frames → CMX timecode at fps (non-drop). */
@@ -284,6 +292,21 @@ export function eventsToAssembleSpec(events, opts = {}) {
     if (durationFrames <= 0) continue;
     const vTrack = trackNum(e.track);
     const cut = { startFrame: recIn, durationFrames, srcIn: toTl(e.srcIn ?? 0, e.fps), ...(vTrack > 1 ? { track: vTrack } : {}) };
+    // CLIP markers from the turnover (OTIO clip markers, XMEML clipitem
+    // <marker>s) become ITEM markers on the cut (frames clip-relative,
+    // nominal→timeline converted; anything landing outside the cut is
+    // dropped rather than refused — a marker on trimmed-away material).
+    if (Array.isArray(e.itemMarkers) && e.itemMarkers.length) {
+      const ims = e.itemMarkers
+        .map((m) => ({
+          frame: Math.round(toTl(m.frame ?? 0, e.fps)),
+          color: COLOR_MAP[String(m.color || '').toLowerCase()] || 'Blue',
+          ...(m.name ? { name: m.name } : {}),
+          ...(m.note ? { note: m.note } : {}),
+        }))
+        .filter((m) => m.frame >= 0 && m.frame < durationFrames);
+      if (ims.length) cut.markers = ims;
+    }
     if ((e.speed ?? 100) !== 100 || e.reverse) {
       const spd = Math.abs(e.speed ?? 100);
       if (!(spd > 0)) {
@@ -532,13 +555,6 @@ export function eventsToAssembleSpec(events, opts = {}) {
   // Turnover markers (EDL * LOC: locators, OTIO Marker objects) → authored
   // timeline markers. Interchange colors map to the measured Resolve names;
   // unknown colors fall back to Blue. Frames are timeline-absolute like cuts.
-  const COLOR_MAP = {
-    blue: 'Blue', cyan: 'Cyan', green: 'Green', yellow: 'Yellow', red: 'Red',
-    pink: 'Pink', purple: 'Purple', magenta: 'Fuchsia', fuchsia: 'Fuchsia',
-    rose: 'Rose', lavender: 'Lavender', sky: 'Sky', mint: 'Mint',
-    lemon: 'Lemon', sand: 'Sand', cocoa: 'Cocoa', cream: 'Cream',
-    orange: 'Sand', white: 'Cream', black: 'Cocoa',
-  };
   const markers = markerEvents
     .map((e) => ({
       frame: ORIGIN + (toTl(e.recIn, e.fps) - minRec),

package/resolve-advanced/server/editorial.mjs

@@ -59,6 +59,7 @@ function evt(o) {
     speed: o.speed ?? 100,
     reverse: o.reverse ?? false,
     transition: o.transition || null,
+    ...(o.itemMarkers !== undefined ? { itemMarkers: o.itemMarkers } : {}),
     fps: o.fps ?? null,
   };
 }
@@ -190,13 +191,14 @@ export function parseOTIO(otio, opts = {}) {
           }
         }
         const src = (child.media_reference && (child.media_reference.target_url || child.media_reference.name)) || child.name || 'UNKNOWN';
+        // CLIP markers belong to the ITEM, not the sequence — carried as
+        // itemMarkers (frames CLIP-relative) so the bridge authors them as
+        // Sm2TiItemLockableBlobs (E80). Track-level markers above remain
+        // timeline markers.
+        const itemMarkers = [];
         for (const mk of child.markers || []) {
           const mrStart = (mk.marked_range && mk.marked_range.start_time && mk.marked_range.start_time.value) || 0;
-          events.push(evt({
-            index: idx++, track: 'MARKER', source: '',
-            recIn: rec + (mrStart - startVal), recOut: null,
-            name: mk.name || undefined, color: mk.color || undefined, fps: rate,
-          }));
+          itemMarkers.push({ frame: mrStart - startVal, name: mk.name || undefined, color: mk.color || undefined });
         }
         events.push(
           evt({
@@ -210,6 +212,7 @@ export function parseOTIO(otio, opts = {}) {
             speed: Math.abs(speed),
             reverse,
             transition: pendingTransition,
+            itemMarkers: itemMarkers.length ? itemMarkers : undefined,
             fps: rate,
           }),
         );
@@ -252,7 +255,13 @@ export function parseXMEMLEvents(xml, opts = {}) {
         }
       }
       if (Number.isFinite(start) && Number.isFinite(end)) {
-        events.push(evt({ index: idx++, track, source: name, srcIn: inF, srcOut: outF, recIn: start, recOut: end, speed, reverse, fps: seqRate }));
+        // FCP7 clipitem <marker> children are CLIP markers (frames relative
+        // to the clip's own <in>) — routed to item markers like OTIO's (E81).
+        const mks = it.marker ? (Array.isArray(it.marker) ? it.marker : [it.marker]) : [];
+        const itemMarkers = mks
+          .filter((mk) => Number.isFinite(Number(mk.in)))
+          .map((mk) => ({ frame: Number(mk.in) - inF, name: mk.name != null ? String(mk.name) : undefined, note: mk.comment != null ? String(mk.comment) : undefined }));
+        events.push(evt({ index: idx++, track, source: name, srcIn: inF, srcOut: outF, recIn: start, recOut: end, speed, reverse, itemMarkers: itemMarkers.length ? itemMarkers : undefined, fps: seqRate }));
       }
     }
   };

package/src/granular/common.py

@@ -87,7 +87,7 @@ if not logging.getLogger().handlers:
         handlers=[logging.StreamHandler()],
     )
 
-VERSION = "2.143.0"
+VERSION = "2.144.0"
 logger = logging.getLogger("davinci-resolve-mcp")
 logger.info(f"Starting DaVinci Resolve MCP Server v{VERSION}")
 logger.info(f"Detected platform: {get_platform()}")

package/src/server.py

@@ -11,7 +11,7 @@ Usage:
     python src/server.py --full       # Start the 353-tool granular server instead
 """
 
-VERSION = "2.143.0"
+VERSION = "2.144.0"
 
 import base64
 import os