scriptor-mcp

Scriptor MCP Server — keyframe and video dependency graph management for scene-based production pipelines.

Quick Start

bun install
bun run start

Tools

Keyframe Graph (kf_graph_*)

Manage keyframe generation order via a DAG with cycle detection and topological scheduling.

| Tool | Description | |------|-------------| | kf_graph_init | Initialize an empty keyframe graph for a scene | | kf_graph_add_shots | Bulk-add shot nodes (pending, no edges) | | kf_graph_add_edge | Add a dependency edge with cycle detection | | kf_graph_add_edges_bulk | Bulk-add edges with per-edge cycle detection | | kf_graph_get_node | Inspect a single shot: status, edges, references | | kf_graph_next_batch | BFS frontier: shots ready to generate in parallel | | kf_graph_execution_plan | Full topological sort into parallelizable layers | | kf_graph_update_status | Update a shot's keyframe status | | kf_graph_summary | Progress dashboard with blocked-shot diagnostics |

Video Graph (vid_graph_*)

Manage video generation ordering based on shot classification (chained/independent/montage).

| Tool | Description | |------|-------------| | vid_graph_init | Initialize an empty video graph for a scene | | vid_graph_classify_shots | Bulk-register shots with classification and continuity groups | | vid_graph_next_batch | BFS frontier: shots ready for video generation | | vid_graph_update_status | Update status, set video/last_frame paths | | vid_graph_get_chain | Get ordered chain of a continuity group | | vid_graph_summary | Progress dashboard for video generation |

Development

bun run dev    # watch mode

Requirements

• Bun runtime