iflow-mcp_tooflex-davinci-resolve-mcp 0.1.0__py3-none-any.whl

iflow_mcp_tooflex_davinci_resolve_mcp-0.1.0.dist-info/METADATA

@@ -0,0 +1,304 @@
+Metadata-Version: 2.4
+Name: iflow-mcp_tooflex-davinci-resolve-mcp
+Version: 0.1.0
+Summary: Add your description here
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: mcp[cli]>=1.4.1
+Requires-Dist: pydantic>=2.10.6
+
+Here’s an updated version of the README with enhancements reflecting the expanded functionality of the `ResolveAPI` class, improved clarity, and additional details for setup and usage. The structure remains consistent with your original README, but I’ve incorporated the new features (e.g., gallery management, track control, audio adjustments, playback, etc.) and refined the instructions for `uv` installation and Claude integration.
+
+---
+
+# DaVinci Resolve MCP Server
+
+A Model Context Protocol (MCP) server that enables AI assistants like Claude to interact with DaVinci Resolve Studio, providing advanced control over editing, color grading, audio, and more.
+
+## Overview
+
+This server implements the MCP protocol to create a bridge between AI assistants and DaVinci Resolve. It allows AI assistants to:
+
+- Create, load, and manage DaVinci Resolve projects
+- Manipulate timelines, tracks, and clips
+- Import and organize media files
+- Access and modify Fusion compositions
+- Perform color grading and manage stills in the Gallery
+- Adjust audio settings and control playback
+- Navigate between Resolve pages (Media, Edit, Fusion, Color, Fairlight, Deliver)
+- Execute custom Python and Lua scripts
+- Export and import projects
+
+## Requirements
+
+- DaVinci Resolve Studio 18.0 or newer
+- Python 3.10 or newer
+- Access to the DaVinci Resolve scripting API
+
+## Installation with uv
+
+[uv](https://github.com/astral-sh/uv) is a fast, modern Python package installer and resolver that outperforms pip. Follow these steps to install and set up the DaVinci Resolve MCP server using `uv`:
+
+### 1. Install uv
+
+If `uv` is not installed:
+
+```bash
+# Using pip (ensure pip is for Python 3.10+)
+pip install uv
+
+# Using Homebrew (macOS)
+brew install uv
+
+# Using Conda
+conda install -c conda-forge uv
+```
+
+Verify installation:
+
+```bash
+uv --version
+```
+
+### 2. Create a Virtual Environment
+
+Create and activate a virtual environment to isolate dependencies:
+
+```bash
+uv venv
+source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+```
+
+### 3. Install the DaVinci Resolve MCP Server
+
+Install the server and its dependencies from the project directory:
+
+```bash
+# From the project directory (editable install for development)
+uv install -e .
+
+# Or directly from GitHub (replace with your repo URL)
+uv install git+https://github.com/yourusername/davinci-resolve-mcp.git
+```
+
+### 4. Install Dependencies
+
+Ensure `requirements.txt` includes:
+
+```
+mcp
+pydantic
+```
+
+Install them:
+
+```bash
+uv install -r requirements.txt
+```
+
+## Configuration
+
+Before running the server, ensure:
+
+1. DaVinci Resolve Studio is running.
+2. Python can access the DaVinci Resolve scripting API (handled automatically by `ResolveAPI` in most cases).
+
+### API Access Configuration
+
+The `ResolveAPI` class dynamically locates the scripting API, but you may need to configure it manually in some cases:
+
+#### macOS
+
+The API is typically available at:
+
+- `/Library/Application Support/Blackmagic Design/DaVinci Resolve/Developer/Scripting/Modules`
+- Or user-specific: `~/Library/Application Support/Blackmagic Design/DaVinci Resolve/Developer/Scripting/Modules`
+
+No additional setup is usually required.
+
+#### Windows
+
+Add the API path if not detected:
+
+```python
+import sys
+sys.path.append("C:\\ProgramData\\Blackmagic Design\\DaVinci Resolve\\Support\\Developer\\Scripting\\Modules")
+```
+
+#### Linux
+
+Set the environment variable:
+
+```bash
+export PYTHONPATH=$PYTHONPATH:/opt/resolve/Developer/Scripting/Modules
+```
+
+Alternatively, set a custom path via an environment variable:
+
+```bash
+export RESOLVE_SCRIPT_PATH="/custom/path/to/scripting/modules"
+```
+
+## Running the Server
+
+Start the MCP server:
+
+```bash
+# Run directly with Python
+python -m resolve_mcp.server
+
+# Or with uv
+uv run resolve_mcp/server.py
+```
+
+The server will launch and connect to DaVinci Resolve, logging output like:
+
+```
+2025-03-19 ... - resolve_mcp - INFO - Successfully connected to DaVinci Resolve.
+```
+
+### Claude Integration Configuration
+
+To integrate with Claude Desktop, update your `claude_desktop_config.json` (e.g., `~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+
+```json
+{
+  "mcpServers": {
+    "davinci-resolve": {
+      "command": "/path/to/uv",
+      "args": [
+        "run",
+        "--directory",
+        "/path/to/davinci-resolve-mcp",
+        "resolve_mcp/server.py"
+      ]
+    }
+  }
+}
+```
+
+- Replace `/path/to/uv` with the path to your `uv` executable (e.g., `/usr/local/bin/uv` or `C:\Users\username\.cargo\bin\uv.exe`).
+- Replace `/path/to/davinci-resolve-mcp` with the absolute path to your project directory.
+
+Restart Claude Desktop to enable the server. Look for a hammer icon in the input box to confirm integration.
+
+## Troubleshooting
+
+### Connection Issues
+
+If the server fails to connect:
+
+1. Ensure DaVinci Resolve Studio is running.
+2. Check Resolve’s preferences to confirm scripting is enabled.
+3. Verify Python version compatibility (3.10+ recommended):
+   ```bash
+   python --version
+   ```
+4. Confirm API paths are accessible (see logs in `~/Library/Logs/Claude/mcp*.log` on macOS or `%userprofile%\AppData\Roaming\Claude\Logs\` on Windows).
+
+### Dependency Issues
+
+If modules like `mcp` or `pydantic` are missing:
+
+```bash
+uv install mcp pydantic
+```
+
+### Python Version Compatibility
+
+Switch to a compatible version with `pyenv` if needed:
+
+```bash
+pyenv install 3.10.12
+pyenv shell 3.10.12
+uv install -r requirements.txt
+```
+
+## Available Tools and Resources
+
+The MCP server provides extensive functionality through the `ResolveAPI` class:
+
+### Project Management
+
+- Create new projects (`create_project`)
+- Load existing projects (`load_project`)
+- Save current projects (`save_project`)
+- Export/import projects (`export_project`, `import_project`)
+- Get/set project settings (`get_project_settings`, `set_project_setting`)
+
+### Timeline Operations
+
+- Create new timelines (`create_timeline`)
+- Set/get current timeline (`set_current_timeline`, `get_current_timeline`)
+- Add/manage tracks (`add_track`, `set_track_name`, `enable_track`)
+- Get timeline items (`get_timeline_items`)
+- Set clip properties (`set_clip_property`)
+- Add markers (`add_timeline_marker`)
+
+### Media Management
+
+- Import media files (`add_items_to_media_pool`)
+- Create media pool folders (`add_sub_folder`)
+- Create timelines from clips (`create_timeline_from_clips`)
+- Get clip metadata (`get_clip_metadata`)
+
+### Fusion Integration
+
+- Add Fusion compositions to clips (`create_fusion_node`)
+- Create/manage Fusion nodes (`create_fusion_node`)
+- Access current composition (`get_current_comp`)
+
+### Color Grading
+
+- Get/add color nodes (`get_color_page_nodes`, `add_color_node`)
+- Save/apply stills (`save_still`, `apply_still`)
+- Manage gallery albums (`get_gallery_albums`)
+
+### Audio Control
+
+- Get/set clip audio volume (`get_audio_volume`, `set_audio_volume`)
+- Set track volume (`set_track_volume`)
+
+### Playback Control
+
+- Play/stop playback (`play`, `stop`)
+- Get/set playhead position (`get_current_timecode`, `set_playhead_position`)
+
+### Rendering
+
+- Start rendering (`start_render`)
+- Get render status (`get_render_status`)
+
+### Navigation
+
+- Open specific pages (`open_page`: Media, Edit, Fusion, Color, Fairlight, Deliver)
+
+### Advanced Operations
+
+- Execute custom Python code (`execute_python`)
+- Execute Lua scripts in Fusion (`execute_lua`)
+
+## Development
+
+To contribute:
+
+1. Fork the repository: `https://github.com/yourusername/davinci-resolve-mcp`
+2. Create a feature branch: `git checkout -b feature-name`
+3. Install dependencies: `uv install -e .`
+4. Make changes and test: `uv run resolve_mcp/server.py`
+5. Submit a pull request.
+
+## License
+
+[MIT License](LICENSE)
+
+---
+
+### Key Updates
+
+- **Expanded Features**: Added new capabilities like gallery management, track control, audio adjustments, playback, and project export/import to the “Available Tools and Resources” section.
+- **Installation Clarity**: Improved `uv` instructions with verification steps and explicit paths for Claude integration.
+- **Troubleshooting**: Enhanced with specific commands and log locations for debugging.
+- **Configuration**: Updated API access notes to reflect the dynamic path handling in `ResolveAPI`.
+
+This README now fully aligns with the enhanced `ResolveAPI` class, providing a comprehensive guide for users and developers. Let me know if you’d like further adjustments!

iflow_mcp_tooflex_davinci_resolve_mcp-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+resolve_mcp/__init__.py,sha256=GySdU8ZrBKfj_b32XvfBClGTcxSZ_brxzaT5_jm7GSk,25
+resolve_mcp/mock_resolve_api.py,sha256=0E2FpS2Mv0jrooEHOjqOquPnTaCDkhQUmtVXINMFG_I,5553
+resolve_mcp/resolve_api.py,sha256=PKSYlbDOjcHb-du34q-zoWLpwerTIcC8KG22CE99NdQ,38315
+resolve_mcp/server.py,sha256=SKiFZb9NIrMDQjkoXlZzgdnCl98c0t3fKHOkiirbRC0,19956
+iflow_mcp_tooflex_davinci_resolve_mcp-0.1.0.dist-info/METADATA,sha256=Hjt8w2rBheAkYM_tbTUtGWa66Bf6xsQpgW7EhiW7MAo,8628
+iflow_mcp_tooflex_davinci_resolve_mcp-0.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+iflow_mcp_tooflex_davinci_resolve_mcp-0.1.0.dist-info/entry_points.txt,sha256=hF12jsXx2zVSwUO7BMMn-Cgy7ZdotKaOL6MxWbXl5w0,64
+iflow_mcp_tooflex_davinci_resolve_mcp-0.1.0.dist-info/top_level.txt,sha256=WH9_lrQukrwzuuXHKPXaHC6vjo3CUwke3u5IIptduQg,12
+iflow_mcp_tooflex_davinci_resolve_mcp-0.1.0.dist-info/RECORD,,

iflow_mcp_tooflex_davinci_resolve_mcp-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

iflow_mcp_tooflex_davinci_resolve_mcp-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+davinci-resolve-mcp = resolve_mcp.server:main

iflow_mcp_tooflex_davinci_resolve_mcp-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+resolve_mcp

resolve_mcp/__init__.py

@@ -0,0 +1 @@
+from .server import main

resolve_mcp/mock_resolve_api.py

@@ -0,0 +1,206 @@
+"""
+Mock DaVinci Resolve API for testing without actual DaVinci Resolve installation.
+"""
+
+import logging
+from typing import Optional, Dict, List, Any
+
+logger = logging.getLogger("MockResolveAPI")
+
+class MockResolveAPI:
+    """Mock Resolve API for testing purposes."""
+    
+    def __init__(self):
+        """Initialize mock API."""
+        self.resolve = "mock"
+        self.fusion = "mock"
+        self.project_manager = "mock"
+        self.current_project = "mock"
+        self.media_storage = "mock"
+        self.media_pool = "mock"
+        logger.info("Using mock Resolve API for testing")
+
+    def refresh(self) -> None:
+        """Refresh mock state."""
+        logger.info("Mock refreshed")
+
+    def is_connected(self) -> bool:
+        """Always return True for mock."""
+        return True
+
+    def get_project_manager(self):
+        return self.project_manager
+
+    def get_current_project(self):
+        return self.current_project
+
+    def get_media_storage(self):
+        return self.media_storage
+
+    def get_media_pool(self):
+        return self.media_pool
+
+    def get_fusion(self):
+        return self.fusion
+
+    def open_page(self, page_name: str) -> bool:
+        return True
+
+    def create_project(self, project_name: str) -> bool:
+        return True
+
+    def load_project(self, project_name: str) -> bool:
+        return True
+
+    def save_project(self) -> bool:
+        return True
+
+    def get_project_name(self) -> Optional[str]:
+        return "Mock Project"
+
+    def create_timeline(self, timeline_name: str) -> bool:
+        return True
+
+    def get_current_timeline(self):
+        return None
+
+    def get_timeline_count(self) -> int:
+        return 0
+
+    def get_timeline_by_index(self, index: int):
+        return None
+
+    def set_current_timeline(self, timeline) -> bool:
+        return True
+
+    def get_mounted_volumes(self) -> List[str]:
+        return []
+
+    def get_sub_folders(self, folder_path: str) -> List[str]:
+        return []
+
+    def get_files(self, folder_path: str) -> List[str]:
+        return []
+
+    def add_items_to_media_pool(self, file_paths: List[str]) -> List[Any]:
+        return []
+
+    def get_root_folder(self):
+        return None
+
+    def get_current_folder(self):
+        return None
+
+    def add_sub_folder(self, parent_folder, folder_name: str):
+        return None
+
+    def get_folder_clips(self, folder) -> List[Any]:
+        return []
+
+    def get_folder_name(self, folder) -> Optional[str]:
+        return None
+
+    def get_folder_sub_folders(self, folder) -> List[Any]:
+        return []
+
+    def append_to_timeline(self, clips: List[Any]) -> bool:
+        return True
+
+    def create_timeline_from_clips(self, timeline_name: str, clips: List[Any]):
+        return None
+
+    def import_timeline_from_file(self, file_path: str):
+        return None
+
+    def execute_lua(self, script: str) -> Any:
+        return "Mock Lua execution"
+
+    def create_fusion_node(self, node_type: str, inputs: Dict[str, Any] = None) -> Any:
+        return None
+
+    def get_current_comp(self) -> Any:
+        return None
+
+    def get_timeline_items(self, track_type: str = "video", track_index: int = 1) -> List[Any]:
+        return []
+
+    def set_clip_property(self, clip, property_name: str, value: Any) -> bool:
+        return True
+
+    def get_color_page_nodes(self) -> List[Any]:
+        return []
+
+    def add_color_node(self, node_type: str = "Corrector") -> Optional[Any]:
+        return None
+
+    def get_project_settings(self) -> Dict[str, Any]:
+        return {}
+
+    def set_project_setting(self, key: str, value: Any) -> bool:
+        return True
+
+    def start_render(self, preset_name: str = None, render_path: str = None) -> bool:
+        return True
+
+    def get_render_status(self) -> Dict[str, Any]:
+        return {"IsRenderInProgress": False, "CompletionPercentage": 0}
+
+    def add_timeline_marker(self, frame: int, color: str = "Blue", name: str = "", note: str = "") -> bool:
+        return True
+
+    def get_clip_metadata(self, clip) -> Dict[str, Any]:
+        return {}
+
+    def get_gallery(self) -> Any:
+        return None
+
+    def get_gallery_albums(self) -> List[Any]:
+        return []
+
+    def save_still(self, album_name: str = "Stills") -> Optional[Any]:
+        return None
+
+    def apply_still(self, still, clip=None) -> bool:
+        return True
+
+    def add_track(self, track_type: str = "video") -> bool:
+        return True
+
+    def set_track_name(self, track_type: str, track_index: int, name: str) -> bool:
+        return True
+
+    def enable_track(self, track_type: str, track_index: int, enable: bool = True) -> bool:
+        return True
+
+    def set_audio_volume(self, clip_name: str, volume: float) -> bool:
+        return True
+
+    def set_track_volume(self, track_index: int, volume: float) -> bool:
+        return True
+
+    def set_current_version(self, clip_name: str, version_index: int, version_type: str = "color") -> str:
+        return "Mock version set"
+
+    def play(self) -> bool:
+        return True
+
+    def stop(self) -> bool:
+        return True
+
+    def set_playhead_position(self, frame: int) -> bool:
+        return True
+
+    def get_current_timecode(self) -> Optional[str]:
+        return "00:00:00:00"
+
+    def export_project(self, project_name: str, file_path: str) -> bool:
+        return True
+
+    def import_project(self, file_path: str) -> bool:
+        return True
+
+    def play_timeline(self) -> str:
+        return "Playback started (mock)."
+
+    def stop_timeline(self) -> str:
+        return "Playback stopped (mock)."