davinci-resolve-mcp 4.14.0 → 4.14.1

package/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 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 v4.14.1 — Setup finds the Mac App Store Studio bundle
+
+Fixes #299.
+
+### Fixed
+
+- **macOS path detection (`install.py`, `src/utils/resolve_runtime.py`, `src/utils/platform.py`, `scripts/doctor.py`)**:
+  the Mac App Store Studio build installs as `/Applications/DaVinci Resolve Studio.app`
+  and keeps `Developer/Scripting` inside the bundle. Setup only knew the installer
+  layout and the free App Store app, and the process check required a path ending
+  in `DaVinci Resolve.app`, so a running Studio app was reported as not running.
+  The installer bundle is still preferred when it is present. App Store Studio is
+  next, then the free App Store app. Auto-launch and restart use that same order.
+
+### Validation
+
+- Path-detection unit tests pass, including the Studio process name, the in-bundle
+  scripting directory, and setup's candidate table.
+- Release static checks pass.
+- The Mac App Store Studio bundle was not connected live. It is not installed on
+  the release machine. The installer app and the free App Store app are.
+
 ## What's New in v4.14.0 — Subtitle presets install, and frame capture puts the render page back
 
 Lands #298. Closes #297 and #296. #295 is only the controls the Word Highlight

package/README.md

@@ -2,7 +2,7 @@
 
 English | [简体中文](README.zh-CN.md)
 
-[![Version](https://img.shields.io/badge/version-4.14.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-4.14.1-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-37%20(390%20full)-blue.svg)](#server-modes)

package/README.zh-CN.md

@@ -2,7 +2,7 @@
 
 [English](README.md) | 简体中文
 
-[![Version](https://img.shields.io/badge/version-4.14.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-4.14.1-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-37%20(390%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)
 
-> 本翻译对应 v4.14.0 版 README。如与英文原版有出入，以 [英文原版](README.md) 为准。
+> 本翻译对应 v4.14.1 版 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 = "4.14.0"
+VERSION = "4.14.1"
 # 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
@@ -225,14 +225,25 @@ def require_current_python(label="Python"):
 
 RESOLVE_PATHS = {
     "Darwin": {
+        # The Library scripting dir is what the installer writes. The Mac App
+        # Store builds never create it; their API lives inside the bundle.
+        # Installer first, then App Store Studio, then the free App Store app,
+        # so a machine with more than one keeps the installer.
         "api": [
             "/Library/Application Support/Blackmagic Design/DaVinci Resolve/Developer/Scripting",
+            "/Applications/DaVinci Resolve/DaVinci Resolve.app/Contents/Resources/Developer/Scripting",
+            "/Applications/DaVinci Resolve Studio.app/Contents/Resources/Developer/Scripting",
+            "/Applications/DaVinci Resolve.app/Contents/Resources/Developer/Scripting",
         ],
         "lib": [
             "/Applications/DaVinci Resolve/DaVinci Resolve.app/Contents/Libraries/Fusion/fusionscript.so",
+            "/Applications/DaVinci Resolve Studio.app/Contents/Libraries/Fusion/fusionscript.so",
+            "/Applications/DaVinci Resolve.app/Contents/Libraries/Fusion/fusionscript.so",
         ],
         "app": [
             "/Applications/DaVinci Resolve/DaVinci Resolve.app",
+            "/Applications/DaVinci Resolve Studio.app",
+            "/Applications/DaVinci Resolve.app",
         ],
     },
     "Windows": {

package/package.json

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

package/scripts/doctor.py

@@ -59,9 +59,22 @@ CODEX_CONFIG = CODEX_HOME / "config.toml"
 #: what made it so confusing to diagnose (issue #106). Linux had the same bug.
 _RESOLVE_PATH_CANDIDATES: dict[str, dict[str, tuple[str, ...]]] = {
     "darwin": {
-        "app": ("/Applications/DaVinci Resolve/DaVinci Resolve.app",),
-        "api": ("/Library/Application Support/Blackmagic Design/DaVinci Resolve/Developer/Scripting",),
-        "lib": ("/Applications/DaVinci Resolve/DaVinci Resolve.app/Contents/Libraries/Fusion/fusionscript.so",),
+        "app": (
+            "/Applications/DaVinci Resolve/DaVinci Resolve.app",
+            "/Applications/DaVinci Resolve Studio.app",
+            "/Applications/DaVinci Resolve.app",
+        ),
+        "api": (
+            "/Library/Application Support/Blackmagic Design/DaVinci Resolve/Developer/Scripting",
+            "/Applications/DaVinci Resolve/DaVinci Resolve.app/Contents/Resources/Developer/Scripting",
+            "/Applications/DaVinci Resolve Studio.app/Contents/Resources/Developer/Scripting",
+            "/Applications/DaVinci Resolve.app/Contents/Resources/Developer/Scripting",
+        ),
+        "lib": (
+            "/Applications/DaVinci Resolve/DaVinci Resolve.app/Contents/Libraries/Fusion/fusionscript.so",
+            "/Applications/DaVinci Resolve Studio.app/Contents/Libraries/Fusion/fusionscript.so",
+            "/Applications/DaVinci Resolve.app/Contents/Libraries/Fusion/fusionscript.so",
+        ),
     },
     "win32": {
         "app": (r"C:\Program Files\Blackmagic Design\DaVinci Resolve\Resolve.exe",),

package/scripts/headless_differential.py

@@ -469,7 +469,10 @@ def resolve_process_argv() -> List[str]:
     try:
         out = subprocess.run(["ps", "-Ao", "pid=,command="], capture_output=True, text=True, timeout=10)
         for line in out.stdout.splitlines():
-            if "DaVinci Resolve.app/Contents/MacOS/Resolve" in line:
+            if (
+                "DaVinci Resolve Studio.app/Contents/MacOS/Resolve" in line
+                or "DaVinci Resolve.app/Contents/MacOS/Resolve" in line
+            ):
                 return line.split()
     except Exception:
         pass

package/src/granular/common.py

@@ -91,7 +91,7 @@ if not logging.getLogger().handlers:
         handlers=[logging.StreamHandler()],
     )
 
-VERSION = "4.14.0"
+VERSION = "4.14.1"
 logger = logging.getLogger("davinci-resolve-mcp")
 logger.info(f"Starting DaVinci Resolve MCP Server v{VERSION}")
 logger.info(f"Detected platform: {get_platform()}")
@@ -422,8 +422,9 @@ def _launch_resolve():
     """Launch DaVinci Resolve and wait for it to become available."""
     sys_name = platform.system().lower()
     if sys_name == "darwin":
-        app_path = "/Applications/DaVinci Resolve/DaVinci Resolve.app"
-        if not os.path.exists(app_path):
+        from src.utils.resolve_runtime import MACOS_RESOLVE_APPS
+        app_path = next((p for p in MACOS_RESOLVE_APPS if os.path.exists(p)), None)
+        if not app_path:
             return False
         subprocess.Popen(["open", app_path], stdin=subprocess.DEVNULL)
     elif sys_name == "windows":

package/src/server.py

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

package/src/utils/app_control.py

@@ -236,7 +236,10 @@ def restart_resolve_app(resolve_obj, wait_seconds: int = 5) -> bool:
     try:
         # Get Resolve executable path for restart
         if platform.system().lower() == 'darwin':
-            resolve_path = '/Applications/DaVinci Resolve/DaVinci Resolve.app'
+            from src.utils.resolve_runtime import MACOS_RESOLVE_APPS
+            resolve_path = next((p for p in MACOS_RESOLVE_APPS if os.path.exists(p)), None)
+            if resolve_path is None:
+                return False
         elif platform.system().lower() == 'windows':
             # Default path, may need to be customized
             resolve_path = r'C:\Program Files\Blackmagic Design\DaVinci Resolve\Resolve.exe'

package/src/utils/platform.py

@@ -61,6 +61,14 @@ def get_resolve_paths():
     if env_api and os.path.isdir(env_api):
         api_path = env_api
         modules_path = os.path.join(api_path, "Modules")
+    elif platform_name == "darwin" and not os.path.isdir(api_path):
+        # The Mac App Store builds keep Developer/Scripting inside the bundle
+        # and never create the /Library path above.
+        for candidate in _macos_api_candidates():
+            if os.path.isdir(candidate):
+                api_path = candidate
+                modules_path = os.path.join(api_path, "Modules")
+                break
     env_lib = os.environ.get("RESOLVE_SCRIPT_LIB")
     if env_lib and os.path.isfile(env_lib):
         lib_path = env_lib
@@ -110,20 +118,35 @@ def _windows_lib_candidates():
     return candidates
 
 
+def _macos_bundles():
+    """Installer, App Store Studio, then the free App Store app.
+
+    Imported lazily: this module is loaded while Resolve support is still
+    being located, and `resolve_runtime` is the list launch already uses.
+    """
+    from .resolve_runtime import MACOS_RESOLVE_APPS
+    return MACOS_RESOLVE_APPS
+
+
 def _macos_lib_candidates():
-    """The App Store bundle as well as the installer one.
+    """Every macOS bundle's fusionscript, in launch order.
 
     The default above names `/Applications/DaVinci Resolve/DaVinci Resolve.app`.
-    The App Store build installs to `/Applications/DaVinci Resolve.app` instead —
-    the same class of miss as a Windows install on another drive, and
-    `resolve_runtime.MACOS_RESOLVE_APPS` already records both.
+    The free App Store build installs to `/Applications/DaVinci Resolve.app`,
+    and App Store Studio to `/Applications/DaVinci Resolve Studio.app`.
     """
     inside_bundle = os.path.join("Contents", "Libraries", "Fusion", "fusionscript.so")
-    bundles = (
-        "/Applications/DaVinci Resolve/DaVinci Resolve.app",
-        "/Applications/DaVinci Resolve.app",
-    )
-    return [os.path.join(bundle, inside_bundle) for bundle in bundles]
+    return [os.path.join(bundle, inside_bundle) for bundle in _macos_bundles()]
+
+
+def _macos_api_candidates():
+    """In-bundle scripting dirs, for builds that never write /Library.
+
+    Checked only when the system scripting directory is absent. The installer
+    build's /Library path stays the default when it exists.
+    """
+    inside_bundle = os.path.join("Contents", "Resources", "Developer", "Scripting")
+    return [os.path.join(bundle, inside_bundle) for bundle in _macos_bundles()]
 
 
 def _linux_lib_candidates():

package/src/utils/resolve_runtime.py

@@ -34,13 +34,16 @@ import subprocess
 from typing import Any, Dict, List, Optional
 
 #: Process paths that mean a DaVinci Resolve application is running. Not the
-#: full path: the App Store build lives at `/Applications/DaVinci Resolve.app`
-#: and the installer build inside `/Applications/DaVinci Resolve/`, and either
-#: one counts.
+#: full path: the free App Store build lives at `/Applications/DaVinci
+#: Resolve.app`, App Store Studio at `/Applications/DaVinci Resolve Studio.app`,
+#: and the installer build inside `/Applications/DaVinci Resolve/`. The Studio
+#: name is its own pattern — `DaVinci Resolve Studio.app` does not end with
+#: `DaVinci Resolve.app`.
 RESOLVE_PROCESS_PATTERNS = (
-    "DaVinci Resolve.app/Contents/MacOS/Resolve",   # macOS, both editions
-    "Resolve.exe",                                  # Windows
-    "/opt/resolve/bin/resolve",                     # Linux
+    "DaVinci Resolve Studio.app/Contents/MacOS/Resolve",  # macOS, App Store Studio
+    "DaVinci Resolve.app/Contents/MacOS/Resolve",         # macOS, installer and free App Store
+    "Resolve.exe",                                        # Windows
+    "/opt/resolve/bin/resolve",                           # Linux
 )
 
 #: The documented headless switch. Blackmagic spells it exactly this way on all
@@ -50,10 +53,12 @@ HEADLESS_FLAG = "-nogui"
 #: Set to 1 to make this server's auto-launch start Resolve without a UI.
 ENV_PREFER_HEADLESS = "DAVINCI_RESOLVE_HEADLESS"
 
-#: macOS puts the two editions in different places. Installer/Studio first, to
-#: preserve the behaviour that a machine with both starts Studio.
+#: macOS puts the editions in different places. Installer first, then App Store
+#: Studio, then the free App Store app: a machine with the installer still
+#: starts that one, and a machine with both App Store editions starts Studio.
 MACOS_RESOLVE_APPS = (
     "/Applications/DaVinci Resolve/DaVinci Resolve.app",
+    "/Applications/DaVinci Resolve Studio.app",
     "/Applications/DaVinci Resolve.app",
 )