davinci-resolve-mcp 4.15.1 → 4.15.3
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 +59 -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/vendor/drp-format/timeline-markers-blob.js +12 -4
- package/scripts/install_resolve_bridge.py +3 -2
- package/src/granular/common.py +1 -1
- package/src/server.py +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,65 @@
|
|
|
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 v4.15.3 — CI covers the version floors
|
|
6
|
+
|
|
7
|
+
No server behavior changed. Pull requests are now tested on the oldest Python
|
|
8
|
+
and Node versions the project supports, not only on newer ones.
|
|
9
|
+
|
|
10
|
+
### Changed
|
|
11
|
+
|
|
12
|
+
- **CI runs the Python job on Python 3.10 as well as 3.11.** 3.10 is the
|
|
13
|
+
declared floor. The bug fixed in v4.15.1 (#314) appeared only on 3.10, and
|
|
14
|
+
CI ran 3.11 alone, so it passed every check.
|
|
15
|
+
- **CI runs the advanced server's own test suite on Node 20 and Node 22.**
|
|
16
|
+
The suite in `resolve-advanced/` had never run in CI. A contributor PR
|
|
17
|
+
(#312) whose code needs Node 22.15+ had a green check while 4 of its tests
|
|
18
|
+
fail on Node 20, the declared floor (`>=20.9`). Each Node version gets a
|
|
19
|
+
clean `npm ci`, because `better-sqlite3` is built for one Node version.
|
|
20
|
+
|
|
21
|
+
### Validation
|
|
22
|
+
|
|
23
|
+
- The first CI run with the new jobs passed on Python 3.10 and 3.11 and on
|
|
24
|
+
Node 20 and 22. Advanced suite: 1,202 tests, 0 failures on both Node
|
|
25
|
+
versions (61 skipped on Node 20, 60 on Node 22; the extra one needs a Node
|
|
26
|
+
22.16+ SQLite API).
|
|
27
|
+
- No Resolve behavior changed; a live test is not required.
|
|
28
|
+
|
|
29
|
+
## What's New in v4.15.2 — Bridge installer and large marker blobs
|
|
30
|
+
|
|
31
|
+
Two contributor fixes.
|
|
32
|
+
|
|
33
|
+
### Fixed
|
|
34
|
+
|
|
35
|
+
- **The bridge installer no longer writes into Blackmagic Disk Speed Test's
|
|
36
|
+
sandbox container** (#315, thanks @gatezh). The macOS installer treats every
|
|
37
|
+
`com.blackmagic-design.*` container as a possible sandboxed Resolve and
|
|
38
|
+
excludes the known helpers by name, but Disk Speed Test was missing from
|
|
39
|
+
that list. The installer copied the bridge scripts and a copy of
|
|
40
|
+
`bridge.json`, auth token included, into a container Resolve never reads,
|
|
41
|
+
and the inflated canary count told users to expect 4 Scripts-menu entries
|
|
42
|
+
where Resolve shows 2. Files already written there are harmless apart from
|
|
43
|
+
the token copy and can be deleted by hand from
|
|
44
|
+
`~/Library/Containers/com.blackmagic-design.DiskSpeedTest/Data/Library/Application Support/`.
|
|
45
|
+
- **Marker blobs over 128 KiB are now valid zstd** (#313, thanks
|
|
46
|
+
@Dev-next-gen). `drt.assemble` wrote timeline and clip markers as one raw
|
|
47
|
+
zstd block. The format caps a block at 128 KiB, so past that size the
|
|
48
|
+
reference decoder rejected the frame, and past 2 MiB assemble threw. The
|
|
49
|
+
writer now splits the payload into blocks of at most 128 KiB. Output up to
|
|
50
|
+
128 KiB is byte-identical to before. The same writer also builds the bin
|
|
51
|
+
registry blob, which gets the same fix.
|
|
52
|
+
|
|
53
|
+
### Validation
|
|
54
|
+
|
|
55
|
+
- Each PR was tested with `main` merged in: the full Python suite for #315
|
|
56
|
+
(only the 4 known worktree path artifacts failed), and the advanced Node
|
|
57
|
+
suite from a fresh `npm ci` for #313 (1,202 tests, 0 failures).
|
|
58
|
+
- #313's frames checked against the reference `zstd` decoder: rejected above
|
|
59
|
+
128 KiB before the fix, accepted at every size up to 2.3 MB after it.
|
|
60
|
+
- How Resolve's own importer treats a marker blob over 128 KiB was not
|
|
61
|
+
measured. The fix makes the frames spec-valid; it is reported, not
|
|
62
|
+
live-verified.
|
|
63
|
+
|
|
5
64
|
## What's New in v4.15.1 — Frame captures arrive as images on Python 3.10
|
|
6
65
|
|
|
7
66
|
### 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
|
-
> 本翻译对应 v4.15.
|
|
15
|
+
> 本翻译对应 v4.15.3 版 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 = "4.15.
|
|
40
|
+
VERSION = "4.15.3"
|
|
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
|
@@ -65,7 +65,7 @@ function encodeMarkerEntry(m) {
|
|
|
65
65
|
return lenDelim(1, Buffer.concat([varField(1, m.frame), lenDelim(2, wrapped)]));
|
|
66
66
|
}
|
|
67
67
|
|
|
68
|
-
/** zstd single-segment frame
|
|
68
|
+
/** zstd single-segment frame of RAW blocks (no compression), 128 KiB per block at most. */
|
|
69
69
|
function zstdRawFrame(payload) {
|
|
70
70
|
const magic = Buffer.from([0x28, 0xb5, 0x2f, 0xfd]);
|
|
71
71
|
let header;
|
|
@@ -76,9 +76,17 @@ function zstdRawFrame(payload) {
|
|
|
76
76
|
header[0] = 0xa0; // single-segment, 4-byte FCS
|
|
77
77
|
header.writeUInt32LE(payload.length, 1);
|
|
78
78
|
}
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
79
|
+
// RFC 8878 caps every block at 128 KiB; libzstd rejects a larger raw block as corrupt.
|
|
80
|
+
const blocks = [];
|
|
81
|
+
let o = 0;
|
|
82
|
+
do {
|
|
83
|
+
const size = Math.min(payload.length - o, 128 * 1024);
|
|
84
|
+
const block = Buffer.alloc(3);
|
|
85
|
+
block.writeUIntLE((size << 3) | (o + size === payload.length ? 1 : 0), 0, 3); // type=raw
|
|
86
|
+
blocks.push(block, payload.subarray(o, o + size));
|
|
87
|
+
o += size;
|
|
88
|
+
} while (o < payload.length);
|
|
89
|
+
return Buffer.concat([magic, header, ...blocks]);
|
|
82
90
|
}
|
|
83
91
|
|
|
84
92
|
function zstdRawInflate(buf) {
|
|
@@ -80,8 +80,9 @@ _SANDBOX_MARKER = "com.blackmagic-design."
|
|
|
80
80
|
#: NOT used outside a sandbox: on a normal install this is genuinely Fusion's
|
|
81
81
|
#: own tree and has nothing to do with Resolve.
|
|
82
82
|
_SANDBOX_FALLBACK_SUFFIX = "Library/Application Support/Fusion/Scripts/Utility"
|
|
83
|
-
#: Containers that are not Resolve (RAW Player, Speed Test,
|
|
84
|
-
|
|
83
|
+
#: Containers that are not Resolve (RAW Player, RAW Speed Test, Disk Speed Test,
|
|
84
|
+
#: the IO XPC helper).
|
|
85
|
+
_NON_RESOLVE_CONTAINERS = ("BlackmagicRaw", "DiskSpeedTest", "IOXPC")
|
|
85
86
|
|
|
86
87
|
#: Windows Scripts/Utility trees, per Blackmagic's own README
|
|
87
88
|
#: (docs/reference/resolve_scripting_api.txt, "Specific user"/"All users").
|
package/src/granular/common.py
CHANGED
|
@@ -91,7 +91,7 @@ if not logging.getLogger().handlers:
|
|
|
91
91
|
handlers=[logging.StreamHandler()],
|
|
92
92
|
)
|
|
93
93
|
|
|
94
|
-
VERSION = "4.15.
|
|
94
|
+
VERSION = "4.15.3"
|
|
95
95
|
logger = logging.getLogger("davinci-resolve-mcp")
|
|
96
96
|
logger.info(f"Starting DaVinci Resolve MCP Server v{VERSION}")
|
|
97
97
|
logger.info(f"Detected platform: {get_platform()}")
|