CutMaster AI
A DaVinci Resolve toolkit with two faces: an MCP server (for AI clients like Claude Code / Desktop) and a CutMaster AI panel (a React UI that runs inside Resolve as a Workflow Integration).
DaVinci Resolve Studio required. The Scripting API is Studio-only ($295). The free edition will not work. Verify via
DaVinci Resolve → About— must say "DaVinci Resolve Studio".
Which path fits you?
| If you want to… | Start here |
|---|---|
| Use CutMaster AI inside Resolve (editors, one-click podcast → YouTube/Shorts cuts) | docs/CUTMASTER_SETUP.md |
| Use MCP tools in Claude Code / Desktop (chat-driven Resolve automation, 233 tools) | docs/SETUP.md |
| Contribute code (Python server, React panel, Resolve plugin, or skills) | docs/CONTRIBUTING.md |
What ships in this repo
| Artifact | What it does | Who consumes it |
|---|---|---|
MCP server (cutmaster-ai) |
233 stdio tools wrapping the Resolve API | Claude Code, Claude Desktop, Cursor, any MCP client |
Panel backend (cutmaster-ai-panel) |
FastAPI HTTP server on 127.0.0.1:8765 that drives CutMaster AI |
The React panel |
| React panel (apps/panel/) | The CutMaster UI | A browser, or Resolve's Workflow Integration webview |
| Resolve Workflow Integration plugin (apps/resolve-plugin/) | Thin Electron wrapper that opens the panel inside Resolve's docked webview | DaVinci Resolve Studio 21+ |
Claude Code plugin (.claude-plugin/ + skills/ + agents/ + hooks/) |
Packaged skills (/deliver, /grade-log etc.), domain agents, safety hooks |
Claude Code CLI |
The Resolve Workflow Integration plugin and the Claude Code plugin are two entirely separate artifacts. They share no files and follow different install paths. See docs/CONTRIBUTING.md for the disambiguation.
Three products that depend on this repo
| # | Name | Audience | Source | Distribution |
|---|---|---|---|---|
| 1 | CutMaster MCP (Claude Code plugin) | AI engineers, Claude Code users | This repo | pip install cutmaster-ai + Claude Code marketplace |
| 2 | CutMaster Resolve Workflow plugin | Any Resolve 21+ user | This repo | Copy into Resolve's plugin folder |
| 3 | CutMaster Studio (paid macOS app) | Colorists, editors, designers | Separate private repo | Notarized DMG from celavii.com — pins a PyPI version of this package |
Studio extends the OSS core via two entry-point groups (cutmaster_ai.tools and cutmaster_ai.panel_routes) — third-party plugins can register the same way. See SURFACE.md for the contract and src/cutmaster_ai/plugins.py for the discovery code.
Features
- 203 granular tools — full coverage of the DaVinci Resolve Scripting API (324 methods)
- 14 workflow tools — compound operations for ingest, assembly, delivery, conform, and grading
- 10 AI tools — Gemini-powered frame analysis, OCR, color assist, editorial critique
- 5 MCP resources — passive context for version, project, timelines, bins, render queue
- 9 skills — Claude Code slash commands (
/deliver,/preflight,/color-assist,/grade-log, etc.) - 7 agents — domain-specific roles (editor, colorist, VFX, sound, conform, delivery, producer)
- Safety hooks — destructive operation warnings, .env protection, auto-lint
- LUT library — registry + installer for 9 camera brands (DJI, Insta360, GoPro, Canon, Nikon, Fujifilm, etc.)
- Auto-launch — starts DaVinci Resolve automatically if not running
- Cross-platform — macOS, Windows, Linux
Quick Start
One-Command Setup (macOS)
git clone https://github.com/CelaviiHQ/cutmaster-ai.git
cd cutmaster-ai
bash scripts/setup.sh
This will create a venv, install all dependencies, configure Claude Desktop, and verify the Resolve connection. For the full setup including global skills, agents, hooks, and auto-start:
bash scripts/setup.sh --all
Interactive Installer
git clone https://github.com/CelaviiHQ/cutmaster-ai.git
cd cutmaster-ai
python3 scripts/install.py
Manual Install
git clone https://github.com/CelaviiHQ/cutmaster-ai.git
cd cutmaster-ai
python3.11 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
Setup & Configuration
For detailed setup instructions — Claude Desktop config, Claude Code skills/agents/hooks, LaunchAgent auto-start, and distributable packaging — see the Complete Setup Guide.
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"cutmaster-ai": {
"command": "/path/to/cutmaster-ai/.venv/bin/python3",
"args": ["-m", "cutmaster_ai"],
"cwd": "/path/to/cutmaster-ai"
}
}
}
Or run python3 scripts/install.py --clients claude-desktop to configure automatically.
Claude Code
The project includes a .mcp.json file — Claude Code auto-detects it:
cd cutmaster-ai
claude
For global access (use from any directory), add the MCP server to ~/.claude/settings.json. See Setup Guide.
Skills, Agents & Hooks Installation
Skills/agents/hooks are Claude Code features. Install globally with:
bash scripts/setup.sh --global
This copies all 9 skills to ~/.claude/commands/, merges hooks into ~/.claude/settings.json, and configures the global MCP server. See Setup Guide.
Auto-Start (macOS LaunchAgent)
Start the MCP server automatically on login:
bash scripts/setup.sh --launchagent
This installs a LaunchAgent at ~/Library/LaunchAgents/ai.cutmaster.mcp.plist. See Setup Guide.
Claude Code Plugin
Build and install as a Claude Code plugin:
bash scripts/build-plugin.sh
claude plugin install ./cutmaster-ai-plugin-v0.1.0.zip
Skills become available as /cutmaster-ai:deliver, /cutmaster-ai:grade-log, etc. See Setup Guide.
Creating a Distributable Package
Share with team members:
bash scripts/package.sh
Creates cutmaster-ai-v0.1.0.zip — the recipient runs bash scripts/setup.sh and they're ready.
Requirements
- DaVinci Resolve Studio 18.5+ — purchase ($295)
- External scripting enabled — Preferences > System > General > External scripting: Local
- Python 3.11+
- uv — fast Python package manager. The committed
.mcp.jsoninvokes the MCP server viauv run, so Claude Code / Desktop won't connect without it. Install:brew install uv # macOS curl -LsSf https://astral.sh/uv/install.sh | sh # Linux powershell -c "irm https://astral.sh/uv/install.ps1 | iex" # Windows
- GEMINI_API_KEY (optional, for AI-powered tools)
Tool Categories
| Category | Tools | Description |
|---|---|---|
| Project | 24 | CRUD, import/export/archive, folders, databases, settings |
| Media Pool | 23 | Bins, clips, import, metadata, search, relink, proxy |
| Render | 20 | Formats, codecs, presets, queue, start/stop/monitor |
| Fusion | 19 | Comp lifecycle, node graph, connections, inputs, undo |
| Timeline Mgmt | 18 | Timeline CRUD, tracks, import/export, duplicate |
| Timeline Items | 17 | Versions, takes, flags, colors, color groups, playhead |
| Timeline Edit | 15 | Properties, transform, crop, speed, generators, titles |
| Color | 12 | CDL, node graph, LUTs, cache, grade copy, stills |
| Markers | 11 | Timeline markers, clip markers, media pool markers |
| Layout | 11 | UI presets, burn-in presets, LUT refresh, keyframe mode |
| Gallery | 9 | Albums, stills, export/import, power grades |
| Graph | 7 | Color groups, pre/post-clip node graphs |
| Interchange | 6 | EDL, FCPXML, AAF, OTIO, CSV export/import |
| Media Storage | 5 | Volumes, browse, files, import, reveal |
| Fairlight | 4 | Audio insertion, voice isolation, track info |
| Scripting | 2 | Execute arbitrary Python or Lua |
Workflow Tools
| Tool | Description |
|---|---|
cutmaster_ingest_media |
Scan folder, import, organise bins, set metadata |
cutmaster_ingest_with_bins |
Mirror folder structure as media pool bins |
cutmaster_quick_assembly |
Create timeline from clips or bin |
cutmaster_assembly_from_bin |
Timeline with track configuration |
cutmaster_quick_deliver |
One-command render with preset shorthands |
cutmaster_batch_deliver |
Multi-format render (h264 + prores + proxy) |
cutmaster_render_status |
Poll render queue progress |
cutmaster_conform_timeline |
Import EDL/XML + relink + verify |
cutmaster_relink_offline_clips |
Fix offline media |
cutmaster_verify_timeline_media |
Check all clips online |
cutmaster_quick_grade |
Apply LUT + CDL + grab still |
cutmaster_batch_apply_lut |
LUT to multiple clips |
cutmaster_copy_grade_to_all |
Copy grade from one clip to all |
cutmaster_setup_log_grade |
6-node structure: WB/EXP/SAT/CURVES/CST/LUT |
cutmaster_list_cst_luts |
List available camera CST LUTs and film looks |
cutmaster_lut_library_status |
Show installed vs available LUTs for all cameras |
cutmaster_install_lut_file |
Install a downloaded .cube/.zip LUT into the library |
cutmaster_get_lut_install_guide |
Step-by-step guide for a camera's LUT |
cutmaster_scan_lut_folder |
Scan all Resolve LUT folders |
AI Tools (requires GEMINI_API_KEY)
| Tool | Description |
|---|---|
cutmaster_analyze_frame |
Gemini vision analysis of current frame |
cutmaster_ocr_frame |
Extract text from current frame |
cutmaster_describe_shot |
Cinematography breakdown |
cutmaster_compare_frames |
A/B comparison with reference image |
cutmaster_frame_info |
Frame metadata (no API key needed) |
cutmaster_color_assist |
AI CDL recommendations with auto-apply |
cutmaster_match_to_reference |
Color match to reference image |
cutmaster_timeline_critique |
AI editorial feedback |
cutmaster_suggest_markers |
AI marker suggestions |
cutmaster_visual_continuity_check |
Cut point analysis |
Skills (Claude Code)
| Command | Description |
|---|---|
/deliver |
Quick render with preset shorthands |
/preflight |
Pre-render verification checklist |
/color-assist |
AI color grading assistant |
/grade-log |
6-node Log footage grading (WB → EXP → SAT → CURVES → CST → LUT) |
/conform |
Timeline conform from EDL/XML |
/ingest |
Media import with organisation |
/assembly |
Build rough cut from clips |
/review |
AI editorial feedback |
/export-stills |
Gallery still batch export |
Agents
| Agent | Role |
|---|---|
| Editor | Timeline assembly, clip arrangement, tracks |
| Colorist | Node trees, LUTs, CDL, grades, stills |
| VFX | Fusion compositions, node graphs |
| Sound | Fairlight audio, voice isolation |
| Conform | EDL/XML import, relinking, round-trip |
| Delivery | Render config, format selection, QC |
| Producer | Project admin, status reports, databases |
AI Setup (Optional)
cp .env.example .env
# Edit .env and set GEMINI_API_KEY=your-key-here
pip install -e ".[all]"
Get a Gemini API key at aistudio.google.com.
Development
python3.11 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
pytest tests/ -v # Run tests (no Resolve needed)
ruff check src/ --fix # Lint
ruff format src/ # Format
python -m cutmaster_ai # Run server
Project Structure
cutmaster-ai/
├── src/cutmaster_ai/
│ ├── config.py # FastMCP server, constants
│ ├── resolve.py # Connection management, helpers
│ ├── errors.py # Exception hierarchy, @safe_resolve_call
│ ├── constants.py # API constants (colors, modes, types)
│ ├── resources.py # 5 MCP resources
│ ├── tools/ # 17 modules (incl. lut_registry), granular tools
│ ├── workflows/ # 6 modules, compound workflow tools
│ ├── intelligence/ # Single-shot LLM tools (vision, color-assist, critique) + shared llm.py
│ ├── cutmaster/ # CutMaster AI product (core/, stt/, analysis/, media/, resolve_ops/, data/)
│ ├── http/ # FastAPI backend for the panel (split routes/cutmaster/ package)
│ └── utils/ # Platform, media, path helpers
├── .claude-plugin/
│ └── plugin.json # Claude Code plugin manifest
├── skills/ # Claude Code skills (plugin distribution)
├── agents/ # Domain agents (plugin distribution)
├── hooks/ # Safety hooks (plugin distribution)
├── apps/
│ ├── panel/ # React panel (Vite, talks to cutmaster-ai-panel)
│ └── resolve-plugin/ # DaVinci Resolve Workflow Integration manifest
├── scripts/
│ ├── install.py # Universal installer (10 MCP clients)
│ ├── build-plugin.sh # Build Claude Code plugin ZIP
│ ├── setup.sh # One-command setup (macOS/Linux)
│ ├── package.sh # Create distributable zip
│ └── launchd/
│ └── ai.cutmaster.mcp.plist # macOS auto-start
├── docs/
│ └── SETUP.md # Complete setup guide
├── tests/ # Test suite
├── .mcp.json # Claude Code project config
└── pyproject.toml # Package config
License
MIT
Metadata
Release files for cutmaster-ai 0.6.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| cutmaster_ai-0.6.0.tar.gz | 2.4 MB | With provenance | Details for cutmaster_ai-0.6.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| cutmaster_ai-0.6.0-py3-none-any.whl | Python 3 | none | any | Details for cutmaster_ai-0.6.0-py3-none-any.whl |
Total release size: 2.8 MB
Release files / cutmaster_ai-0.6.0.tar.gz
| Download URL | cutmaster_ai-0.6.0.tar.gz |
|---|---|
| Size | 2.4 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
438f1b18234ba22bd4a77ac3f05eb083e3450c54b37efa249eecd7beca649f3b
|
|
BLAKE2b-256 checksum How to use checksums |
3980deb264d3f4b830c1f436a00f02e89c838c2d256ea430927a064ae7e7dfda
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 26, 2026.
Transparency logRelease files / cutmaster_ai-0.6.0-py3-none-any.whl
| Download URL | cutmaster_ai-0.6.0-py3-none-any.whl |
|---|---|
| Size | 402.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b53d0de1e2c0551f0f143f91903a1619f941bfc3e55d43b73a39d1b49b621cec
|
|
BLAKE2b-256 checksum How to use checksums |
0b1a732032be48ac576eab2e39d932b651927389142bc92b8031ded5de72b032
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 26, 2026.
Transparency logSecurity for cutmaster-ai 0.6.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for cutmaster_ai-0.6.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 26, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.