davinci-resolve-mcp 2.160.0 → 2.162.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +33 -0
- package/README.md +1 -1
- package/README.zh-CN.md +2 -2
- package/install.py +1 -1
- package/package.json +1 -1
- package/resolve-advanced/server/aaf_probe.py +11 -0
- package/resolve-advanced/server/author-interchange.mjs +5 -1
- package/resolve-advanced/server/editorial.mjs +7 -0
- package/resolve-advanced/server/tools/editorial.mjs +1 -1
- package/src/granular/common.py +1 -1
- package/src/server.py +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,39 @@
|
|
|
2
2
|
|
|
3
3
|
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.
|
|
4
4
|
|
|
5
|
+
## What's New in v2.162.0 — freeze parity: Avid 0% motion effects are freezes
|
|
6
|
+
|
|
7
|
+
### Fixed
|
|
8
|
+
|
|
9
|
+
- **An Avid freeze frame silently read as a 100% clip.** A motion effect at
|
|
10
|
+
0% (`PARAM_SPEED_RATIO_U 0.0`, or a flat speed map at 0) fell into the AAF
|
|
11
|
+
walker's "no play rate recoverable" branch, and the freeze vanished. An
|
|
12
|
+
explicit zero now reports `speed: 0, freeze: true`, and the bridge authors
|
|
13
|
+
the real freeze — completing freeze parity across all five ingest formats
|
|
14
|
+
(EDL `M2 000.0`, OTIO `FreezeFrame`, XMEML `timeremap` 0, PrProj
|
|
15
|
+
`InPoint == OutPoint`, and now AAF).
|
|
16
|
+
|
|
17
|
+
## What's New in v2.161.0 — OTIO freeze frames close the loop
|
|
18
|
+
|
|
19
|
+
### Fixed
|
|
20
|
+
|
|
21
|
+
- **OTIO `FreezeFrame` effects were silently lost at parse**: the reader only
|
|
22
|
+
looked at `time_scalar`, which FreezeFrame writers commonly omit, so a
|
|
23
|
+
turnover freeze read as a plain 100% clip. The schema itself now means
|
|
24
|
+
speed 0, and the bridge authors the real freeze `Sm2TimeMap`.
|
|
25
|
+
|
|
26
|
+
### Added
|
|
27
|
+
|
|
28
|
+
- The OTIO writer emits `FreezeFrame.1` (time_scalar 0) for zero-speed
|
|
29
|
+
events — OTIO's own schema for it, readable by both conventions.
|
|
30
|
+
|
|
31
|
+
### Measured
|
|
32
|
+
|
|
33
|
+
- **Resolve's `EXPORT_OTIO` writes an authored freeze back as
|
|
34
|
+
`FreezeFrame.1` with `time_scalar: 0`** — the freeze round-trips
|
|
35
|
+
losslessly, and `verify_roundtrip` now catches a freeze flattened to 100%
|
|
36
|
+
as retime drift.
|
|
37
|
+
|
|
5
38
|
## What's New in v2.160.0 — write-side span fidelity; the flat DRT target stops lying about black
|
|
6
39
|
|
|
7
40
|
### Fixed
|
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
English | [简体中文](README.zh-CN.md)
|
|
4
4
|
|
|
5
|
-
[](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
|
|
6
6
|
[](https://www.npmjs.com/package/davinci-resolve-mcp)
|
|
7
7
|
[](docs/reference/api-coverage.md)
|
|
8
8
|
[-blue.svg)](#server-modes)
|
package/README.zh-CN.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
[English](README.md) | 简体中文
|
|
4
4
|
|
|
5
|
-
[](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
|
|
6
6
|
[](https://www.npmjs.com/package/davinci-resolve-mcp)
|
|
7
7
|
[](docs/reference/api-coverage.md)
|
|
8
8
|
[-blue.svg)](#服务器模式)
|
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
[](https://www.python.org/downloads/)
|
|
13
13
|
[](https://opensource.org/licenses/MIT)
|
|
14
14
|
|
|
15
|
-
> 本翻译对应 v2.
|
|
15
|
+
> 本翻译对应 v2.162.0 版 README。如与英文原版有出入，以 [英文原版](README.md) 为准。
|
|
16
16
|
|
|
17
17
|
一个 Model Context Protocol (MCP) 服务器，让 AI 助手通过官方脚本 API 控制 DaVinci Resolve Studio（达芬奇）。它提供完整的 API 覆盖，外加带护栏的工作流助手，涵盖剪辑、媒体池整理、渲染设置、审阅标记、调色、Fusion、Fairlight、项目生命周期任务、扩展开发，以及不碰源媒体的媒体分析。
|
|
18
18
|
|
package/install.py
CHANGED
|
@@ -37,7 +37,7 @@ from src.utils.update_check import (
|
|
|
37
37
|
|
|
38
38
|
# ─── Version ──────────────────────────────────────────────────────────────────
|
|
39
39
|
|
|
40
|
-
VERSION = "2.
|
|
40
|
+
VERSION = "2.162.0"
|
|
41
41
|
# Only hard floor: mcp[cli] requires Python 3.10+. There is no upper bound —
|
|
42
42
|
# Resolve's scripting bridge loads into newer interpreters on recent builds
|
|
43
43
|
# (Python 3.14 verified against Resolve Studio 20.3.2). Older Resolve builds
|
package/package.json
CHANGED
|
@@ -726,6 +726,11 @@ def _retime_fields(op_group):
|
|
|
726
726
|
play = None
|
|
727
727
|
speed_map = None
|
|
728
728
|
offset_map = None
|
|
729
|
+
# An EXPLICIT zero play rate is a freeze (Avid motion effect at 0%,
|
|
730
|
+
# E104): PARAM_SPEED_RATIO_U == 0.0 or a flat PARAM_SPEED_MAP_U at 0.
|
|
731
|
+
# It must not read as "nothing recoverable" — a freeze that silently
|
|
732
|
+
# became 100% is the loudest timing lie of all.
|
|
733
|
+
zero_seen = False
|
|
729
734
|
length = _length(op_group)
|
|
730
735
|
for param in _op_parameters(op_group):
|
|
731
736
|
cls = type(param).__name__
|
|
@@ -754,6 +759,8 @@ def _retime_fields(op_group):
|
|
|
754
759
|
continue
|
|
755
760
|
if value:
|
|
756
761
|
play = value # *_U family stores the play rate directly
|
|
762
|
+
else:
|
|
763
|
+
zero_seen = True
|
|
757
764
|
curve = {}
|
|
758
765
|
for key, param in (("playRate", speed_map), ("sourceOffset", offset_map)):
|
|
759
766
|
if param is None:
|
|
@@ -782,7 +789,11 @@ def _retime_fields(op_group):
|
|
|
782
789
|
return {"speedVarying": True, **extra}
|
|
783
790
|
if play is None and values and values[0]:
|
|
784
791
|
play = values[0] # a flat map's single value IS the constant play rate
|
|
792
|
+
elif play is None and values and values[0] == 0:
|
|
793
|
+
zero_seen = True
|
|
785
794
|
if not play:
|
|
795
|
+
if zero_seen:
|
|
796
|
+
return {"speedRatio": 0.0, "speed": 0, "reverse": False, "freeze": True, **extra}
|
|
786
797
|
return extra
|
|
787
798
|
return {
|
|
788
799
|
"speedRatio": round(abs(play), 6),
|
|
@@ -152,7 +152,11 @@ export function eventsToOTIO(events, opts = {}) {
|
|
|
152
152
|
},
|
|
153
153
|
active_media_reference_key: 'DEFAULT_MEDIA',
|
|
154
154
|
};
|
|
155
|
-
if ((e.speed ?? 100)
|
|
155
|
+
if ((e.speed ?? 100) === 0) {
|
|
156
|
+
// Zero speed = freeze: OTIO's own schema for it (a LinearTimeWarp
|
|
157
|
+
// subclass with time_scalar 0), readable by both conventions (E103).
|
|
158
|
+
clip.effects.push({ OTIO_SCHEMA: 'FreezeFrame.1', name: 'Freeze', metadata: {}, effect_name: 'FreezeFrame', time_scalar: 0 });
|
|
159
|
+
} else if ((e.speed ?? 100) !== 100 || e.reverse) {
|
|
156
160
|
clip.effects.push({ OTIO_SCHEMA: 'LinearTimeWarp.1', name: 'Speed', metadata: {}, effect_name: 'LinearTimeWarp', time_scalar: (e.reverse ? -1 : 1) * ((e.speed ?? 100) / 100) });
|
|
157
161
|
}
|
|
158
162
|
if (e.transition) {
|
|
@@ -216,6 +216,13 @@ export function parseOTIO(otio, opts = {}) {
|
|
|
216
216
|
speed = +(eff.time_scalar * 100).toFixed(2);
|
|
217
217
|
reverse = eff.time_scalar < 0;
|
|
218
218
|
}
|
|
219
|
+
// OTIO FreezeFrame is a LinearTimeWarp subclass whose time_scalar
|
|
220
|
+
// is 0 by definition — writers commonly omit the field, which
|
|
221
|
+
// read as a plain 100% clip here (E103). Speed 0 authors a freeze.
|
|
222
|
+
if (/^FreezeFrame\b/.test(String(eff.OTIO_SCHEMA || ''))) {
|
|
223
|
+
speed = 0;
|
|
224
|
+
reverse = false;
|
|
225
|
+
}
|
|
219
226
|
}
|
|
220
227
|
const src = (child.media_reference && (child.media_reference.target_url || child.media_reference.name)) || child.name || 'UNKNOWN';
|
|
221
228
|
// CLIP markers belong to the ITEM, not the sequence — carried as
|
|
@@ -86,7 +86,7 @@ const markerSchema = z.object({
|
|
|
86
86
|
export const editorialTool = {
|
|
87
87
|
name: 'editorial',
|
|
88
88
|
description:
|
|
89
|
-
'Editorial integrity (Cluster E) — turnover interchange → normalized events → changelist + conform manifest with TIMING silent-lie guards (flattened retime / dropped J/L-cut audio / framerate-pulldown slip / reverse dropped / transition-handle starvation → flag, skip-not-fake). Report-only (gate: review). Actions: parse_interchange (EDL/OTIO/XMEML natively + AAF via pyaaf2 + PRPROJ via gunzip+XML → normalized events incl. span-explicit transitions
|
|
89
|
+
'Editorial integrity (Cluster E) — turnover interchange → normalized events → changelist + conform manifest with TIMING silent-lie guards (flattened retime / dropped J/L-cut audio / framerate-pulldown slip / reverse dropped / transition-handle starvation → flag, skip-not-fake). Report-only (gate: review). Actions: parse_interchange (EDL/OTIO/XMEML natively + AAF via pyaaf2 + PRPROJ via gunzip+XML → normalized events incl. span-explicit transitions, BL fade legs, and freezes as zero-speed events (OTIO FreezeFrame, XMEML timeremap 0, PrProj in==out, AAF 0% motion effects); for AAF/PRPROJ pass the file PATH as content; AAF also returns per-sequence startTimecode/startFrame — build the timeline at THAT start, not the Resolve 01:00:00:00 default — and per-clip `geometry` for Avid transform effects), list_sequences (ONE offline picker entry point across xml/edl/otio/drt/drp/aaf/prproj → [{id,name,eventCount}], plus startTimecode/startFrame for AAF), convert_to_interchange (author OTIO/EDL/DRT Resolve CAN import from events or a parsed source; the EDL target writes CMX transition pairs incl. BL fades — the .prproj→Resolve conform bridge, no Premiere needed; editorial timing/transitions survive and per-clip effects/color do not. SPEED/REVERSE survive on the otio (LinearTimeWarp) and edl (M2) targets ONLY — this FLAT drt target flattens every retime to 100% forward and returns `flattened`/`flattenedCount` naming each event that lost one (`flattened` is always present on `drt`, empty when there were none); for a .drt that AUTHORS retimes/dissolves/multi-track/audio, use drt.assemble_from_interchange), turnover_changelist (diff old vs new → moved/retimed/replaced/new/gone + timing flags), conform_manifest (per-event assert: source resolved/handles/retime/reverse/TC-base; BL-aware — black legs need no source, fades no black-side handles, and a fade-out tail requirement lands on the picture source), marker_roundtrip (markers with provenance tags), verify_roundtrip (input events vs re-export events -> pass/mismatches + fitted per-source TC offsets + marker compare w/ markersNotInExport honesty flag; FADE-AWARE: BL/Solid-Color legs merge out as blackSegments and fade-window boundary reshapes are excused into fadeReshapedBoundaries instead of failing; RETIME-AWARE: speed/reverse compare pairwise — EXPORT_OTIO carries an authored Sm2TimeMap back as LinearTimeWarp (measured), so a flattened/lost retime fails as drift geometry alone cannot catch; AUDIO-AWARE: declared audio events compare (channel legs deduped, mismatches tagged trackType audio) while the mirrored-A1 export of a video-only turnover stays informational; the conform QC loop-closer). Offline (AAF needs pyaaf2; live AAF/DRP import is on the Python davinci-resolve MCP).',
|
|
90
90
|
async handler({ action, args }) {
|
|
91
91
|
if (action === 'parse_interchange') {
|
|
92
92
|
const p = parseSchema.parse(args);
|
package/src/granular/common.py
CHANGED
|
@@ -87,7 +87,7 @@ if not logging.getLogger().handlers:
|
|
|
87
87
|
handlers=[logging.StreamHandler()],
|
|
88
88
|
)
|
|
89
89
|
|
|
90
|
-
VERSION = "2.
|
|
90
|
+
VERSION = "2.162.0"
|
|
91
91
|
logger = logging.getLogger("davinci-resolve-mcp")
|
|
92
92
|
logger.info(f"Starting DaVinci Resolve MCP Server v{VERSION}")
|
|
93
93
|
logger.info(f"Detected platform: {get_platform()}")
|