davinci-resolve-mcp 4.4.2 → 4.5.0

package/src/granular/project.py

@@ -61,6 +61,7 @@ def get_project_setting(setting_name: str) -> Dict[str, Any]:
 
 
 @mcp.tool(annotations=DESTRUCTIVE_TOOL)
+@granular_destructive_op()
 def set_project_setting(setting_name: str, setting_value: Any) -> str:
     """Set a project setting to the specified value.
     
@@ -250,6 +251,7 @@ def save_project() -> str:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def close_project() -> str:
     """Close the current project.
     
@@ -306,6 +308,7 @@ def get_cache_settings() -> Dict[str, Any]:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def set_cache_mode(mode: str) -> str:
     """Set cache mode for the current project.
     
@@ -340,6 +343,7 @@ def set_cache_mode(mode: str) -> str:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def set_optimized_media_mode(mode: str) -> str:
     """Set optimized media mode for the current project.
     
@@ -374,6 +378,7 @@ def set_optimized_media_mode(mode: str) -> str:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def set_proxy_mode(mode: str) -> str:
     """Set proxy media mode for the current project.
     
@@ -408,6 +413,7 @@ def set_proxy_mode(mode: str) -> str:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def set_proxy_quality(quality: str) -> str:
     """Set proxy media quality for the current project.
     
@@ -442,6 +448,7 @@ def set_proxy_quality(quality: str) -> str:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def set_cache_path(path_type: str, path: str) -> str:
     """Set cache file path for the current project.
     
@@ -501,6 +508,7 @@ def create_cloud_project_tool(
 
 
 @mcp.tool()
+@granular_destructive_op()
 def load_cloud_project_tool(
     project_name: Optional[str] = None,
     project_media_path: Optional[str] = None,
@@ -594,6 +602,7 @@ def get_project_property_endpoint(property_name: str) -> Dict[str, Any]:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def set_project_property_tool(property_name: str, property_value: Any) -> str:
     """Set a project property value.
     
@@ -624,6 +633,7 @@ def get_timeline_format() -> Dict[str, Any]:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def set_timeline_format_tool(width: int, height: int, frame_rate: float, interlaced: bool = False) -> str:
     """Set timeline format (resolution and frame rate).
     
@@ -657,6 +667,7 @@ def get_superscale_settings_endpoint() -> Dict[str, Any]:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def set_superscale_settings_tool(enabled: bool, quality: int = 0) -> str:
     """Set SuperScale settings for the current project.
     
@@ -695,6 +706,7 @@ def get_color_settings_endpoint() -> Dict[str, Any]:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def set_color_science_mode_tool(mode: str) -> str:
     """Set color science mode for the current project.
     
@@ -714,6 +726,7 @@ def set_color_science_mode_tool(mode: str) -> str:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def set_color_space_tool(color_space: str, gamma: str = None) -> str:
     """Set timeline color space and gamma.
     
@@ -776,6 +789,7 @@ def archive_project(project_name: str, archive_path: str, archive_src_media: boo
 
 
 @mcp.tool()
+@granular_destructive_op()
 def delete_project(project_name: str) -> Dict[str, Any]:
     """Delete a project from the current database. WARNING: This is irreversible.
 
@@ -810,6 +824,7 @@ def create_project_folder(folder_name: str) -> Dict[str, Any]:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def delete_project_folder(folder_name: str) -> Dict[str, Any]:
     """Delete a folder from the current project folder location.
 
@@ -953,6 +968,7 @@ def get_database_list() -> Dict[str, Any]:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def set_current_database(db_info: Dict[str, str]) -> Dict[str, Any]:
     """Switch to a different database.
 
@@ -968,6 +984,7 @@ def set_current_database(db_info: Dict[str, str]) -> Dict[str, Any]:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def set_project_name(name: str) -> Dict[str, Any]:
     """Rename the current project.
 
@@ -1017,6 +1034,7 @@ def get_project_preset_list() -> Dict[str, Any]:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def set_project_preset(preset_name: str) -> Dict[str, Any]:
     """Apply a project preset to the current project.
 
@@ -1034,6 +1052,7 @@ def set_project_preset(preset_name: str) -> Dict[str, Any]:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def delete_render_job(job_id: str) -> Dict[str, Any]:
     """Delete a specific render job by its ID.
 
@@ -1085,6 +1104,7 @@ def start_rendering_jobs(job_ids: Optional[List[str]] = None, is_interactive_mod
 
 
 @mcp.tool()
+@granular_destructive_op()
 def stop_rendering() -> Dict[str, Any]:
     """Stop the current rendering process."""
     resolve = get_resolve()
@@ -1111,6 +1131,7 @@ def is_rendering_in_progress() -> Dict[str, Any]:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def load_render_preset(preset_name: str) -> Dict[str, Any]:
     """Load a render preset by name.
 
@@ -1145,6 +1166,7 @@ def save_as_new_render_preset(preset_name: str) -> Dict[str, Any]:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def delete_render_preset(preset_name: str) -> Dict[str, Any]:
     """Delete a render preset.
 
@@ -1162,6 +1184,7 @@ def delete_render_preset(preset_name: str) -> Dict[str, Any]:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def set_render_settings(settings: Dict[str, Any]) -> Dict[str, Any]:
     """Set render settings for the current project.
 
@@ -1254,6 +1277,7 @@ def get_current_render_format_and_codec() -> Dict[str, Any]:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def set_current_render_format_and_codec(format_name: str, codec_name: str) -> Dict[str, Any]:
     """Set the render format and codec.
 
@@ -1297,6 +1321,7 @@ def get_current_render_mode() -> Dict[str, Any]:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def set_current_render_mode(mode: int) -> Dict[str, Any]:
     """Set the render mode.
 
@@ -1375,6 +1400,7 @@ def insert_audio_to_current_track(file_path: str) -> Dict[str, Any]:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def load_burn_in_preset(preset_name: str) -> Dict[str, Any]:
     """Load a burn-in preset by name for the project.
 
@@ -1441,6 +1467,7 @@ def add_color_group(group_name: str) -> Dict[str, Any]:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def delete_color_group(group_name: str) -> Dict[str, Any]:
     """Delete a color group from the current project.
 
@@ -1588,6 +1615,7 @@ def add_render_job() -> Dict[str, Any]:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def load_cloud_project(project_name: str, project_media_path: str, sync_mode: str = "proxy") -> Dict[str, Any]:
     """Load a cloud project from DaVinci Resolve cloud.
 

package/src/granular/resolve_211.py

@@ -9,6 +9,7 @@ from src.utils.resolve211_edits import validate_edit_options, validate_transitio
 from src.granular.common import (
     mcp, READ_ONLY_TOOL, WRITE_TOOL, DESTRUCTIVE_TOOL, get_resolve, get_current_project,
     _get_timeline, _get_timeline_item, _resolve_safe_dir, _find_clip_by_id, _requires_method, has_method,
+    granular_destructive_op,
 )
 
 
@@ -190,6 +191,7 @@ def set_timeline_item_fades(options: dict, track_type: str = "video", track_inde
 
 
 @mcp.tool(annotations=DESTRUCTIVE_TOOL)
+@granular_destructive_op()
 def add_timeline_item_transition(options: dict, track_type: str = "video", track_index: int = 1, item_index: int = 0) -> dict:
     """Add a native 21.1 transition using type/category/position/alignment and optional duration in frames. Returns actual span; clip indexes can change after insertion."""
     error = validate_transition_options(options)
@@ -207,6 +209,7 @@ def add_timeline_item_transition(options: dict, track_type: str = "video", track
 
 
 @mcp.tool(annotations=DESTRUCTIVE_TOOL)
+@granular_destructive_op()
 def create_multicam_clip(clip_ids: list[str], options: dict | None = None) -> dict:
     """Create native 21.1 multicam clips. Options follow MulticamOptions; named Resolve constants or numeric values accepted. Resolves every ID before writing."""
     _, p = get_current_project()
@@ -220,6 +223,7 @@ def create_multicam_clip(clip_ids: list[str], options: dict | None = None) -> di
 
 
 @mcp.tool(annotations=DESTRUCTIVE_TOOL)
+@granular_destructive_op()
 def flatten_timeline_item_multicam(grade_option: str = "FLATTEN_MULTICAM_COPY_GRADE", track_type: str = "video", track_index: int = 1, item_index: int = 0) -> dict:
     """Flatten a native multicam item using COPY_GRADE or RETAIN_GRADE_FROM_ANGLE. Re-query items after replacement."""
     if track_type not in ("video", "audio") or track_index < 1 or item_index < 0:
@@ -237,6 +241,7 @@ def flatten_timeline_item_multicam(grade_option: str = "FLATTEN_MULTICAM_COPY_GR
 
 
 @mcp.tool(annotations=DESTRUCTIVE_TOOL)
+@granular_destructive_op()
 def set_timeline_output_blanking(options: dict) -> dict:
     """Set native 21.1 timeline Top/Bottom/Left/Right pixel coordinates."""
     error = validate_blanking(options)
@@ -252,6 +257,7 @@ def set_timeline_output_blanking(options: dict) -> dict:
 
 
 @mcp.tool(annotations=DESTRUCTIVE_TOOL)
+@granular_destructive_op()
 def set_timeline_item_output_blanking(options: dict, track_type: str = "video", track_index: int = 1, item_index: int = 0) -> dict:
     """Set native 21.1 clip pixel coordinates. Disable timeline blanking inheritance first; this call does not change inheritance."""
     error = validate_blanking(options)
@@ -269,6 +275,7 @@ def set_timeline_item_output_blanking(options: dict, track_type: str = "video",
 
 
 @mcp.tool(annotations=DESTRUCTIVE_TOOL)
+@granular_destructive_op()
 def set_timeline_item_use_timeline_for_output_blanking(use_timeline: bool, track_type: str = "video", track_index: int = 1, item_index: int = 0) -> dict:
     """Explicitly enable/disable native 21.1 timeline blanking inheritance for a clip."""
     if type(use_timeline) is not bool:
@@ -285,6 +292,7 @@ def set_timeline_item_use_timeline_for_output_blanking(use_timeline: bool, track
 
 
 @mcp.tool(annotations=DESTRUCTIVE_TOOL)
+@granular_destructive_op()
 def normalize_timeline_audio_level(item_ids: list[str], options: dict | None = None) -> dict:
     """Native 21.1 normalization of explicit audio timeline item IDs. Options normalizationMode, targetLevel (dBFS), targetLoudness (LKFS), setLevelMode; use get_normalize_audio_modes for names."""
     _, timeline, error = _get_timeline()
@@ -297,6 +305,7 @@ def normalize_timeline_audio_level(item_ids: list[str], options: dict | None = N
 
 
 @mcp.tool(annotations=DESTRUCTIVE_TOOL)
+@granular_destructive_op()
 def auto_align_timeline_clips(item_ids: list[str], options: dict | None = None) -> dict:
     """Native 21.1 alignment of current video/audio items by unique ID. Include linked audio AND video IDs to move both; selection is not expanded. Options SyncUsing and UseTrack accept documented constant names or integral native values."""
     _, timeline, error = _get_timeline()

package/src/granular/resolve_control.py

@@ -228,6 +228,7 @@ def save_layout_preset_tool(preset_name: str) -> Dict[str, Any]:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def load_layout_preset_tool(preset_name: str) -> Dict[str, Any]:
     """Load a UI layout preset.
 
@@ -282,6 +283,7 @@ def import_layout_preset_tool(import_path: str, preset_name: str = None) -> Dict
 
 
 @mcp.tool()
+@granular_destructive_op()
 def delete_layout_preset_tool(preset_name: str) -> Dict[str, Any]:
     """Delete a layout preset.
 
@@ -325,6 +327,7 @@ def get_app_state_endpoint() -> Dict[str, Any]:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def quit_app(force: bool = False, save_project: bool = True) -> str:
     """
     Quit DaVinci Resolve application.
@@ -346,6 +349,7 @@ def quit_app(force: bool = False, save_project: bool = True) -> str:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def restart_app(wait_seconds: int = 5) -> str:
     """
     Restart DaVinci Resolve application.
@@ -515,6 +519,7 @@ def get_keyframe_mode() -> Dict[str, Any]:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def set_keyframe_mode(mode: int) -> Dict[str, Any]:
     """Set the keyframe mode in Resolve.
 
@@ -545,6 +550,7 @@ def get_fairlight_presets() -> Dict[str, Any]:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def quit_resolve() -> Dict[str, Any]:
     """Quit DaVinci Resolve. WARNING: This will close the application."""
     resolve = get_resolve()
@@ -591,6 +597,7 @@ def get_burn_in_preset_list() -> Dict[str, Any]:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def delete_burn_in_preset(preset_name: str) -> Dict[str, Any]:
     """Delete a data burn-in preset by name (Resolve 21.0.4+).
 
@@ -641,6 +648,7 @@ def save_user_preferences_preset(preset_name: str) -> Dict[str, Any]:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def load_user_preferences_preset(preset_name: str) -> Dict[str, Any]:
     """Load a user-preferences preset (Resolve 21.0.4+).
 
@@ -662,6 +670,7 @@ def load_user_preferences_preset(preset_name: str) -> Dict[str, Any]:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def delete_user_preferences_preset(preset_name: str) -> Dict[str, Any]:
     """Delete a user-preferences preset by name (Resolve 21.0.4+).
 

package/src/granular/timeline.py

@@ -105,6 +105,7 @@ def create_timeline(name: str) -> str:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def set_current_timeline(name: str) -> str:
     """Switch to a timeline by name.
     
@@ -203,6 +204,7 @@ def list_timelines_tool() -> List[str]:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def timeline_set_name(name: str) -> Dict[str, Any]:
     """Rename the current timeline.
 
@@ -217,6 +219,7 @@ def timeline_set_name(name: str) -> Dict[str, Any]:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def timeline_set_start_timecode(timecode: str) -> Dict[str, Any]:
     """Set the start timecode of the current timeline.
 
@@ -240,6 +243,7 @@ def timeline_get_current_timecode() -> Dict[str, Any]:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def timeline_set_current_timecode(timecode: str) -> Dict[str, Any]:
     """Set the playhead to a specific timecode.
 
@@ -288,6 +292,7 @@ def timeline_add_track(
 
 
 @mcp.tool()
+@granular_destructive_op()
 def timeline_delete_track(track_type: str, track_index: int) -> Dict[str, Any]:
     """Delete a track from the timeline.
 
@@ -318,6 +323,7 @@ def timeline_get_track_sub_type(track_type: str, track_index: int) -> Dict[str,
 
 
 @mcp.tool()
+@granular_destructive_op()
 def timeline_set_track_enable(track_type: str, track_index: int, enabled: bool) -> Dict[str, Any]:
     """Enable or disable a track.
 
@@ -349,6 +355,7 @@ def timeline_get_is_track_enabled(track_type: str, track_index: int) -> Dict[str
 
 
 @mcp.tool()
+@granular_destructive_op()
 def timeline_set_track_lock(track_type: str, track_index: int, locked: bool) -> Dict[str, Any]:
     """Lock or unlock a track.
 
@@ -397,6 +404,7 @@ def timeline_get_voice_isolation_state(track_index: int) -> Dict[str, Any]:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def timeline_set_voice_isolation_state(track_index: int, state: Dict[str, Any]) -> Dict[str, Any]:
     """Set voice isolation state for an audio track.
 
@@ -415,6 +423,7 @@ def timeline_set_voice_isolation_state(track_index: int, state: Dict[str, Any])
 
 
 @mcp.tool()
+@granular_destructive_op()
 def timeline_delete_clips(clip_ids: List[str], track_type: str = "video", track_index: int = 1) -> Dict[str, Any]:
     """Delete clips from the timeline.
 
@@ -437,6 +446,7 @@ def timeline_delete_clips(clip_ids: List[str], track_type: str = "video", track_
 
 
 @mcp.tool()
+@granular_destructive_op()
 def timeline_set_clips_linked(clip_ids: List[str], linked: bool, track_type: str = "video", track_index: int = 1) -> Dict[str, Any]:
     """Link or unlink clips in the timeline.
 
@@ -533,6 +543,7 @@ def timeline_get_marker_custom_data(frame_id: int) -> Dict[str, Any]:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def timeline_delete_markers_by_color(color: str) -> Dict[str, Any]:
     """Delete all timeline markers of a specific color.
 
@@ -547,6 +558,7 @@ def timeline_delete_markers_by_color(color: str) -> Dict[str, Any]:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def timeline_delete_marker_at_frame(frame_id: int) -> Dict[str, Any]:
     """Delete a timeline marker at a specific frame.
 
@@ -561,6 +573,7 @@ def timeline_delete_marker_at_frame(frame_id: int) -> Dict[str, Any]:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def timeline_delete_marker_by_custom_data(custom_data: str) -> Dict[str, Any]:
     """Delete a timeline marker by custom data.
 
@@ -590,6 +603,7 @@ def timeline_get_track_name(track_type: str, track_index: int) -> Dict[str, Any]
 
 
 @mcp.tool()
+@granular_destructive_op()
 def timeline_set_track_name(track_type: str, track_index: int, name: str) -> Dict[str, Any]:
     """Set the name of a track.
 
@@ -882,6 +896,7 @@ def timeline_create_subtitles_from_audio(
 # the timeline by adding cuts. The compound server rates timeline_ai.detect_scene_cuts
 # destructive; this is the same Resolve call, so it carries the same hint.
 @mcp.tool(annotations=DESTRUCTIVE_TOOL)
+@granular_destructive_op()
 def timeline_detect_scene_cuts() -> Dict[str, Any]:
     """Detect scene cuts in the current timeline. DESTRUCTIVE — adds cuts to the timeline."""
     _, tl, err = _get_timeline()
@@ -987,6 +1002,7 @@ def timeline_get_mark_in_out() -> Dict[str, Any]:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def timeline_set_mark_in_out(mark_in: int, mark_out: int) -> Dict[str, Any]:
     """Set mark in/out points for the current timeline.
 
@@ -1002,6 +1018,7 @@ def timeline_set_mark_in_out(mark_in: int, mark_out: int) -> Dict[str, Any]:
 
 
 @mcp.tool()
+@granular_destructive_op()
 def timeline_clear_mark_in_out() -> Dict[str, Any]:
     """Clear mark in/out points for the current timeline."""
     _, tl, err = _get_timeline()
@@ -1084,6 +1101,7 @@ def create_timeline_from_clips(
 
 
 @mcp.tool()
+@granular_destructive_op()
 def set_timeline_setting(setting_name: str, setting_value: str) -> Dict[str, Any]:
     """Set a timeline setting value.