davinci-resolve-mcp 2.28.0 → 2.28.1

package/CHANGELOG.md

@@ -2,6 +2,30 @@
 
 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.28.1
+
+Bug-fix release.
+
+**Audio transcription no longer passes an invalid `language` argument.** The
+`transcribe_audio` (clip) and `transcribe_folder_audio` tools in the full
+(`--full`) server were calling `TranscribeAudio(language)` with a language
+string, but the Resolve scripting API has never accepted a language positional —
+its signature is `TranscribeAudio(useSpeakerDetection=None)`. The string was
+silently coerced to a truthy boolean and misread as a speaker-detection flag,
+and the success message falsely claimed a transcription language. The language
+is controlled by the project's Speech Recognition setting, not per call.
+
+- `transcribe_audio(clip_name, use_speaker_detection=None)` — the `language`
+  parameter is replaced with an optional `use_speaker_detection` boolean
+  (Resolve 21+). Omit it to use the project's setting.
+- `transcribe_folder_audio(folder_name, use_speaker_detection=None)` — same
+  change for the folder-level tool.
+- Both pass the boolean through only when supplied, so older Resolve builds
+  (which take no argument) keep working.
+
+The consolidated 32-tool server was unaffected — its `folder`/`media_pool_item`
+`transcribe_audio` actions already called `TranscribeAudio()` correctly.
+
 ## What's New in v2.28.0
 
 This release adds a structural timeline-diff engine, a declarative project spec

package/README.md

@@ -1,6 +1,6 @@
 # DaVinci Resolve MCP Server
 
-[![Version](https://img.shields.io/badge/version-2.28.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-2.28.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-32%20(329%20full)-blue.svg)](#server-modes)

package/install.py

@@ -35,7 +35,7 @@ from src.utils.update_check import (
 
 # ─── Version ──────────────────────────────────────────────────────────────────
 
-VERSION = "2.28.0"
+VERSION = "2.28.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

package/package.json

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

package/src/granular/common.py

@@ -80,7 +80,7 @@ if not logging.getLogger().handlers:
         handlers=[logging.StreamHandler()],
     )
 
-VERSION = "2.28.0"
+VERSION = "2.28.1"
 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/granular/folder.py

@@ -58,12 +58,16 @@ def export_folder(folder_name: str, export_path: str, export_type: str = "DRB")
 
 
 @mcp.tool()
-def transcribe_folder_audio(folder_name: str, language: str = "en-US") -> str:
+def transcribe_folder_audio(folder_name: str, use_speaker_detection: Optional[bool] = None) -> str:
     """Transcribe audio for all clips in a folder.
-    
+
+    The transcription language follows the project's Speech Recognition setting
+    (Project Settings > Subtitles), not a per-call argument.
+
     Args:
         folder_name: Name of the folder containing clips to transcribe
-        language: Language code for transcription (default: en-US)
+        use_speaker_detection: Optional (Resolve 21+). Enable speaker detection.
+            If omitted, the project's setting is used.
     """
     pm, current_project = get_current_project()
     if not current_project:
@@ -90,11 +94,16 @@ def transcribe_folder_audio(folder_name: str, language: str = "en-US") -> str:
     if not target_folder:
         return f"Error: Folder '{folder_name}' not found in Media Pool"
     
-    # Transcribe audio in the folder
+    # Transcribe audio in the folder.
+    # Resolve 21's signature is TranscribeAudio(useSpeakerDetection=None); pass the
+    # bool only when supplied so older Resolve builds (no arg) keep working.
     try:
-        result = target_folder.TranscribeAudio(language)
+        if use_speaker_detection is None:
+            result = target_folder.TranscribeAudio()
+        else:
+            result = target_folder.TranscribeAudio(use_speaker_detection)
         if result:
-            return f"Successfully started audio transcription for folder '{folder_name}' in language '{language}'"
+            return f"Successfully started audio transcription for folder '{folder_name}'"
         else:
             return f"Failed to start audio transcription for folder '{folder_name}'"
     except Exception as e:

package/src/granular/media_pool_item.py

@@ -162,12 +162,16 @@ def replace_clip(clip_name: str, replacement_path: str) -> str:
 
 
 @mcp.tool()
-def transcribe_audio(clip_name: str, language: str = "en-US") -> str:
+def transcribe_audio(clip_name: str, use_speaker_detection: Optional[bool] = None) -> str:
     """Transcribe audio for a clip.
-    
+
+    The transcription language follows the project's Speech Recognition setting
+    (Project Settings > Subtitles), not a per-call argument.
+
     Args:
         clip_name: Name of the clip to transcribe
-        language: Language code for transcription (default: en-US)
+        use_speaker_detection: Optional (Resolve 21+). Enable speaker detection.
+            If omitted, the project's setting is used.
     """
     pm, current_project = get_current_project()
     if not current_project:
@@ -189,10 +193,15 @@ def transcribe_audio(clip_name: str, language: str = "en-US") -> str:
     if not target_clip:
         return f"Error: Clip '{clip_name}' not found in Media Pool"
     
+    # Resolve 21's signature is TranscribeAudio(useSpeakerDetection=None); pass the
+    # bool only when supplied so older Resolve builds (no arg) keep working.
     try:
-        result = target_clip.TranscribeAudio(language)
+        if use_speaker_detection is None:
+            result = target_clip.TranscribeAudio()
+        else:
+            result = target_clip.TranscribeAudio(use_speaker_detection)
         if result:
-            return f"Successfully started audio transcription for clip '{clip_name}' in language '{language}'"
+            return f"Successfully started audio transcription for clip '{clip_name}'"
         else:
             return f"Failed to start audio transcription for clip '{clip_name}'"
     except Exception as e:

package/src/server.py

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