davinci-resolve-mcp 2.145.0 → 2.145.2

package/CHANGELOG.md

@@ -2,6 +2,38 @@
 
 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.145.2 — launcher metadata before dependencies
+
+### Fixed
+
+- **`davinci-resolve-advanced-mcp --help`/`--version` now work in fresh
+  source checkouts** (before `npm install`) — adapted from
+  [PR #178](https://github.com/samuelgursky/davinci-resolve-mcp/pull/178) by
+  @Rohitkanithi: metadata flags are handled before the stdio server import
+  (and before the Node-floor refusal — help is harmless on any Node), where
+  previously even `--help` died with `ERR_MODULE_NOT_FOUND`.
+- **The installer banner's tool counts were stale** (32/329 vs the real
+  36/353) — fixed and wired into the `test_doc_tool_counts` drift guard so
+  the banner can never drift independently again.
+
+## What's New in v2.145.1 — bridge config override, honored end to end
+
+### Fixed
+
+- **The free-edition bridge installer now honors
+  `DAVINCI_RESOLVE_BRIDGE_CONFIG`** — adapted from
+  [PR #177](https://github.com/samuelgursky/davinci-resolve-mcp/pull/177) by
+  @altiss. The bridge client already resolved the override, but the installer
+  always wrote and embedded the fixed default path, so a client configured
+  with an override could look in one place while the in-app bridge was
+  installed with another — both sides "successfully" installed yet never
+  sharing a token. The installer resolves the effective path at call time
+  with the client's exact semantics (env wins, `~` expands, default
+  otherwise) across create, report, runtime copy, and launcher embed. One
+  correction on top of the PR: the step-4 probe guidance keeps pointing at
+  the FIXED default directory — the probe runs inside Resolve, which never
+  inherits the shell's environment, so it always writes there.
+
 ## What's New in v2.145.0 — whole projects, assembled offline
 
 ### Added

package/README.md

@@ -2,7 +2,7 @@
 
 English | [简体中文](README.zh-CN.md)
 
-[![Version](https://img.shields.io/badge/version-2.145.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-2.145.2-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)
@@ -52,6 +52,11 @@ python scripts/install_resolve_bridge.py
 # restart Resolve, open a project, then: Workspace > Scripts > resolve_bridge
 ```
 
+The installer and MCP client use `~/.config/davinci-resolve-mcp/bridge.json`
+by default. To keep the authenticated bridge config elsewhere, set
+`DAVINCI_RESOLVE_BRIDGE_CONFIG` while running the installer and in the MCP
+client environment; both sides will use that path.
+
 Once that listener is running it is used **automatically** whenever external
 scripting is unavailable — no environment variable required. Setting
 `DAVINCI_RESOLVE_BRIDGE=1` *forces* the bridge instead: it becomes the only

package/README.zh-CN.md

@@ -2,7 +2,7 @@
 
 [English](README.md) | 简体中文
 
-[![Version](https://img.shields.io/badge/version-2.145.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-2.145.2-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.145.0 版 README。如与英文原版有出入，以 [英文原版](README.md) 为准。
+> 本翻译对应 v2.145.2 版 README。如与英文原版有出入，以 [英文原版](README.md) 为准。
 
 一个 Model Context Protocol (MCP) 服务器，让 AI 助手通过官方脚本 API 控制 DaVinci Resolve Studio（达芬奇）。它提供完整的 API 覆盖，外加带护栏的工作流助手，涵盖剪辑、媒体池整理、渲染设置、审阅标记、调色、Fusion、Fairlight、项目生命周期任务、扩展开发，以及不碰源媒体的媒体分析。
 

package/bin/davinci-resolve-advanced-mcp.mjs

@@ -11,8 +11,36 @@
  */
 
 import { fileURLToPath, pathToFileURL } from 'node:url';
+import fs from 'node:fs';
 import path from 'node:path';
 
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const packageRoot = path.resolve(__dirname, '..');
+const packageJson = JSON.parse(fs.readFileSync(path.join(packageRoot, 'package.json'), 'utf8'));
+const version = packageJson.version || '0.0.0-dev';
+
+function usage() {
+  return `DaVinci Resolve Advanced MCP ${version}
+
+Usage:
+  davinci-resolve-advanced-mcp
+  davinci-resolve-advanced-mcp --version
+  davinci-resolve-advanced-mcp --help
+
+Starts the offline DaVinci Resolve advanced MCP server over stdio.
+`;
+}
+
+const command = process.argv[2];
+if (command === '--help' || command === '-h' || command === 'help') {
+  process.stdout.write(usage());
+  process.exit(0);
+}
+if (command === '--version' || command === '-v' || command === 'version') {
+  process.stdout.write(`${version}\n`);
+  process.exit(0);
+}
+
 // Node floor (package.json engines: >=20.9), enforced at STARTUP rather than
 // discovered per-feature: under an old Node the pure-JS tools limp along
 // while native-dep paths (better-sqlite3: project_read, fairlight DB actions,
@@ -34,7 +62,6 @@ if (major < 20 || (major === 20 && minor < 9)) {
   process.exit(1);
 }
 
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const serverEntry = path.resolve(__dirname, '..', 'resolve-advanced', 'server', 'index.mjs');
 
 const { startServer } = await import(pathToFileURL(serverEntry).href);

package/install.py

@@ -37,7 +37,7 @@ from src.utils.update_check import (
 
 # ─── Version ──────────────────────────────────────────────────────────────────
 
-VERSION = "2.145.0"
+VERSION = "2.145.2"
 # 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
@@ -1474,7 +1474,7 @@ def verify_resolve_connection(python_path, api_path, lib_path):
 
 def print_banner():
     title = f"DaVinci Resolve MCP Server — Installer v{VERSION}"
-    subtitle = "32 compound · 329 full · 3 platforms"
+    subtitle = "36 compound · 353 full · 3 platforms"
     print()
     print(bold("  ╔══════════════════════════════════════════════════════╗"))
     print(bold(f"  ║{title:^54}║"))

package/package.json

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

package/scripts/install_resolve_bridge.py

@@ -24,10 +24,17 @@ import sys
 from pathlib import Path
 
 REPO = Path(__file__).resolve().parent.parent
-CONFIG_DIR = Path.home() / ".config/davinci-resolve-mcp"
-CONFIG_PATH = CONFIG_DIR / "bridge.json"
+DEFAULT_CONFIG_PATH = Path.home() / ".config/davinci-resolve-mcp/bridge.json"
+ENV_CONFIG_PATH = "DAVINCI_RESOLVE_BRIDGE_CONFIG"
 DEFAULT_PORT = 49632
 
+
+def config_path() -> Path:
+    """Bridge config written by this installer and read by the MCP client."""
+    override = os.environ.get(ENV_CONFIG_PATH)
+    return Path(override).expanduser() if override else DEFAULT_CONFIG_PATH
+
+
 _SCRIPTS_SUFFIX = "Library/Application Support/Blackmagic Design/DaVinci Resolve/Fusion/Scripts/Utility"
 
 #: A sandboxed (App Store) build sees its container as HOME, so Resolve's
@@ -448,10 +455,11 @@ def python_preflight() -> dict:
 
 
 def ensure_config(port: int, rotate: bool) -> dict:
+    path = config_path()
     existing: dict = {}
-    if CONFIG_PATH.exists():
+    if path.exists():
         try:
-            existing = json.loads(CONFIG_PATH.read_text(encoding="utf-8"))
+            existing = json.loads(path.read_text(encoding="utf-8"))
         except (OSError, ValueError):
             existing = {}
     token = existing.get("token")
@@ -469,12 +477,12 @@ def ensure_config(port: int, rotate: bool) -> dict:
         "allowed_media_roots": existing_media or [str(Path.home())],
         "allowed_output_roots": existing_output or [str(Path.home() / "Movies")],
     }
-    CONFIG_DIR.mkdir(mode=0o700, parents=True, exist_ok=True)
-    tmp = CONFIG_PATH.with_suffix(".tmp")
+    path.parent.mkdir(mode=0o700, parents=True, exist_ok=True)
+    tmp = path.with_suffix(".tmp")
     tmp.write_text(json.dumps(config, indent=2, sort_keys=True), encoding="utf-8")
     os.chmod(tmp, 0o600)
-    tmp.replace(CONFIG_PATH)
-    os.chmod(CONFIG_PATH, 0o600)
+    tmp.replace(path)
+    os.chmod(path, 0o600)
     return config
 
 
@@ -525,8 +533,9 @@ def install(*, probe_only: bool, port: int, rotate: bool) -> dict:
         )
     result["skipped"] = [path for path, _ in skipped]
     if not probe_only:
-        loaded = json.loads(CONFIG_PATH.read_text(encoding="utf-8"))
-        result["config"] = {"path": str(CONFIG_PATH),
+        path = config_path()
+        loaded = json.loads(path.read_text(encoding="utf-8"))
+        result["config"] = {"path": str(path),
                             **{k: v for k, v in loaded.items() if k != "token"}}
     return result
 
@@ -558,9 +567,10 @@ def _install_to(target: Path, *, probe_only: bool, installed: list[str]) -> None
     # unreachable by construction (measured: "Operation not permitted").
     # The runtime dir is already inside the container, so the config goes
     # beside the modules. Same token, so the out-of-sandbox client still
-    # authenticates against ~/.config.
+    # authenticates against the selected config path.
     runtime_config = runtime / "bridge.json"
-    shutil.copy2(CONFIG_PATH, runtime_config)
+    path = config_path()
+    shutil.copy2(path, runtime_config)
     os.chmod(runtime_config, 0o600)
     installed.append(str(runtime_config))
     # The launcher IS the menu entry. Without it the modules sit in the
@@ -571,7 +581,7 @@ def _install_to(target: Path, *, probe_only: bool, installed: list[str]) -> None
         base64.urlsafe_b64encode(str(runtime).encode("utf-8")).decode("ascii"),
     ).replace(
         "@@CONFIG_PATH_B64@@",
-        base64.urlsafe_b64encode(str(CONFIG_PATH).encode("utf-8")).decode("ascii"),
+        base64.urlsafe_b64encode(str(path).encode("utf-8")).decode("ascii"),
     )
     launcher_path = target / "resolve_bridge.py"
     launcher_path.write_text(launcher, encoding="utf-8")
@@ -605,6 +615,9 @@ def main() -> int:
     print("  1. Restart DaVinci Resolve so it re-scans the Scripts folders.")
     print("  2. Open a saved project (the Scripts menu is empty in Project Manager).")
     print("  3. Workspace > Scripts > resolve_bridge_probe  — run it TWICE.")
+    # The probe runs INSIDE Resolve, which never sees the shell's
+    # DAVINCI_RESOLVE_BRIDGE_CONFIG — it always writes to the fixed default
+    # directory, so the guidance must not follow the override.
     print("  4. Read ~/.config/davinci-resolve-mcp/host-model-probe.json")
     return 0
 

package/src/granular/common.py

@@ -87,7 +87,7 @@ if not logging.getLogger().handlers:
         handlers=[logging.StreamHandler()],
     )
 
-VERSION = "2.145.0"
+VERSION = "2.145.2"
 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.145.0"
+VERSION = "2.145.2"
 
 import base64
 import os