16 KiB
Executable File
16 KiB
Executable File
FCP MCP Server - Tool Schemas
Complete MCP tool definitions for all editing capabilities.
Phase 1: Core Editing
add_marker
{
"name": "add_marker",
"description": "Add a marker to the timeline at a specific timecode. Supports chapter markers (for YouTube), to-do markers, and standard markers with custom colors.",
"inputSchema": {
"type": "object",
"properties": {
"project_path": {
"type": "string",
"description": "Path to the FCPXML file"
},
"timecode": {
"type": "string",
"description": "Timecode in format HH:MM:SS:FF or seconds (e.g., '00:01:30:00' or '90.5')"
},
"name": {
"type": "string",
"description": "Marker name/label"
},
"marker_type": {
"type": "string",
"enum": ["standard", "chapter", "todo", "completed"],
"default": "standard",
"description": "Type of marker to create"
},
"color": {
"type": "string",
"enum": ["blue", "cyan", "green", "yellow", "orange", "red", "pink", "purple"],
"default": "blue",
"description": "Marker color"
},
"note": {
"type": "string",
"description": "Optional note/description for the marker"
}
},
"required": ["project_path", "timecode", "name"]
}
}
trim_clip
{
"name": "trim_clip",
"description": "Adjust the in-point and/or out-point of a clip in the timeline. Can trim by timecode or by duration delta.",
"inputSchema": {
"type": "object",
"properties": {
"project_path": {
"type": "string",
"description": "Path to the FCPXML file"
},
"clip_id": {
"type": "string",
"description": "Unique identifier of the clip (from list_clips)"
},
"trim_start": {
"type": "string",
"description": "New in-point timecode, or delta like '+00:00:01:00' or '-15f' (frames)"
},
"trim_end": {
"type": "string",
"description": "New out-point timecode, or delta like '+00:00:02:00' or '-30f'"
},
"ripple": {
"type": "boolean",
"default": true,
"description": "If true, subsequent clips shift to fill/accommodate the change"
}
},
"required": ["project_path", "clip_id"]
}
}
reorder_clips
{
"name": "reorder_clips",
"description": "Move one or more clips to a new position in the timeline. Supports moving single clips or batch reordering.",
"inputSchema": {
"type": "object",
"properties": {
"project_path": {
"type": "string",
"description": "Path to the FCPXML file"
},
"clip_ids": {
"type": "array",
"items": {"type": "string"},
"description": "List of clip IDs to move (maintains relative order)"
},
"target_position": {
"type": "string",
"description": "Where to insert: 'start', 'end', timecode, or 'after:clip_id' / 'before:clip_id'"
},
"ripple": {
"type": "boolean",
"default": true,
"description": "If true, other clips shift to accommodate"
}
},
"required": ["project_path", "clip_ids", "target_position"]
}
}
add_transition
{
"name": "add_transition",
"description": "Apply a transition between two clips or at clip boundaries.",
"inputSchema": {
"type": "object",
"properties": {
"project_path": {
"type": "string",
"description": "Path to the FCPXML file"
},
"clip_id": {
"type": "string",
"description": "Clip ID to add transition to"
},
"position": {
"type": "string",
"enum": ["start", "end", "both"],
"default": "end",
"description": "Where to apply the transition"
},
"transition_type": {
"type": "string",
"enum": ["cross-dissolve", "fade-to-black", "fade-from-black", "dip-to-color", "wipe", "slide"],
"default": "cross-dissolve",
"description": "Type of transition"
},
"duration": {
"type": "string",
"default": "00:00:00:15",
"description": "Transition duration in timecode or frames (e.g., '15f')"
}
},
"required": ["project_path", "clip_id"]
}
}
Phase 2: Speed & Precision
change_speed
{
"name": "change_speed",
"description": "Modify the playback speed of a clip. Supports constant speed changes and speed ramps.",
"inputSchema": {
"type": "object",
"properties": {
"project_path": {
"type": "string",
"description": "Path to the FCPXML file"
},
"clip_id": {
"type": "string",
"description": "Unique identifier of the clip"
},
"speed": {
"type": "number",
"description": "Speed multiplier (0.5 = 50% slow-mo, 2.0 = 2x fast)"
},
"ramp": {
"type": "object",
"description": "Optional speed ramp configuration",
"properties": {
"start_speed": {"type": "number"},
"end_speed": {"type": "number"},
"curve": {
"type": "string",
"enum": ["linear", "ease-in", "ease-out", "ease-in-out"]
}
}
},
"preserve_pitch": {
"type": "boolean",
"default": true,
"description": "Maintain audio pitch when changing speed"
},
"frame_blending": {
"type": "string",
"enum": ["none", "frame-blending", "optical-flow"],
"default": "optical-flow",
"description": "Frame interpolation method for slow-motion"
}
},
"required": ["project_path", "clip_id", "speed"]
}
}
split_clip
{
"name": "split_clip",
"description": "Split a clip at one or more timecodes, creating separate clips.",
"inputSchema": {
"type": "object",
"properties": {
"project_path": {
"type": "string",
"description": "Path to the FCPXML file"
},
"clip_id": {
"type": "string",
"description": "Unique identifier of the clip to split"
},
"split_points": {
"type": "array",
"items": {"type": "string"},
"description": "List of timecodes within the clip to split at"
},
"split_type": {
"type": "string",
"enum": ["blade", "blade-all"],
"default": "blade",
"description": "'blade' splits only this clip, 'blade-all' splits all tracks at this point"
}
},
"required": ["project_path", "clip_id", "split_points"]
}
}
delete_clip
{
"name": "delete_clip",
"description": "Remove a clip from the timeline. Supports ripple delete or leaving a gap.",
"inputSchema": {
"type": "object",
"properties": {
"project_path": {
"type": "string",
"description": "Path to the FCPXML file"
},
"clip_ids": {
"type": "array",
"items": {"type": "string"},
"description": "List of clip IDs to delete"
},
"ripple": {
"type": "boolean",
"default": true,
"description": "If true, subsequent clips shift to fill the gap"
}
},
"required": ["project_path", "clip_ids"]
}
}
Phase 3: Batch & AI-Powered
select_by_keyword
{
"name": "select_by_keyword",
"description": "Find and return clips matching specific keywords, ratings, or metadata criteria.",
"inputSchema": {
"type": "object",
"properties": {
"project_path": {
"type": "string",
"description": "Path to the FCPXML file"
},
"keywords": {
"type": "array",
"items": {"type": "string"},
"description": "Keywords to match (OR logic by default)"
},
"match_mode": {
"type": "string",
"enum": ["any", "all", "none"],
"default": "any",
"description": "'any' = OR, 'all' = AND, 'none' = exclude these keywords"
},
"rating": {
"type": "object",
"properties": {
"min": {"type": "integer", "minimum": 1, "maximum": 5},
"max": {"type": "integer", "minimum": 1, "maximum": 5}
},
"description": "Filter by star rating range"
},
"favorites_only": {
"type": "boolean",
"default": false,
"description": "Only return favorited clips"
},
"exclude_rejected": {
"type": "boolean",
"default": true,
"description": "Exclude clips marked as rejected"
}
},
"required": ["project_path", "keywords"]
}
}
batch_trim
{
"name": "batch_trim",
"description": "Apply trim operations to multiple clips at once based on criteria.",
"inputSchema": {
"type": "object",
"properties": {
"project_path": {
"type": "string",
"description": "Path to the FCPXML file"
},
"clip_ids": {
"type": "array",
"items": {"type": "string"},
"description": "List of clip IDs to trim (or use selection_criteria)"
},
"selection_criteria": {
"type": "object",
"description": "Alternative to clip_ids: select clips dynamically",
"properties": {
"keywords": {"type": "array", "items": {"type": "string"}},
"min_duration": {"type": "string"},
"max_duration": {"type": "string"}
}
},
"trim_operation": {
"type": "object",
"properties": {
"trim_start_by": {"type": "string", "description": "Amount to trim from start"},
"trim_end_by": {"type": "string", "description": "Amount to trim from end"},
"set_duration": {"type": "string", "description": "Set all clips to this exact duration"}
}
},
"ripple": {
"type": "boolean",
"default": true
}
},
"required": ["project_path", "trim_operation"]
}
}
auto_rough_cut
{
"name": "auto_rough_cut",
"description": "AI-powered rough cut generation. Analyzes source clips by keywords and assembles a timeline based on target duration and pacing preferences.",
"inputSchema": {
"type": "object",
"properties": {
"source_path": {
"type": "string",
"description": "Path to FCPXML with source clips (library or event export)"
},
"output_path": {
"type": "string",
"description": "Path to write the generated rough cut FCPXML"
},
"target_duration": {
"type": "string",
"description": "Desired final duration (e.g., '00:03:30:00' for 3.5 minutes)"
},
"structure": {
"type": "array",
"description": "Ordered list of segments with keywords and duration targets",
"items": {
"type": "object",
"properties": {
"name": {"type": "string", "description": "Segment name (e.g., 'Intro', 'Verse 1')"},
"keywords": {"type": "array", "items": {"type": "string"}},
"duration": {"type": "string", "description": "Target duration for this segment"},
"priority": {"type": "string", "enum": ["favorites", "longest", "shortest", "random"]}
}
}
},
"pacing": {
"type": "string",
"enum": ["slow", "medium", "fast", "dynamic"],
"default": "medium",
"description": "Overall pacing feel - affects average cut length"
},
"pacing_config": {
"type": "object",
"description": "Advanced pacing controls",
"properties": {
"min_clip_duration": {"type": "string", "default": "00:00:01:00"},
"max_clip_duration": {"type": "string", "default": "00:00:08:00"},
"avg_clip_duration": {"type": "string"},
"vary_pacing": {"type": "boolean", "default": true, "description": "Vary cut lengths for organic feel"}
}
},
"transitions": {
"type": "object",
"properties": {
"between_segments": {"type": "string", "enum": ["none", "cross-dissolve", "fade-to-black"], "default": "cross-dissolve"},
"within_segments": {"type": "string", "enum": ["none", "cut", "cross-dissolve"], "default": "cut"}
}
},
"include_audio": {
"type": "boolean",
"default": true,
"description": "Include audio from clips"
},
"music_track": {
"type": "string",
"description": "Optional path to music file to lay under the rough cut"
}
},
"required": ["source_path", "output_path", "target_duration"]
}
}
Utility Tools
batch_add_markers
{
"name": "batch_add_markers",
"description": "Add multiple markers at once from a list or based on detection criteria.",
"inputSchema": {
"type": "object",
"properties": {
"project_path": {
"type": "string",
"description": "Path to the FCPXML file"
},
"markers": {
"type": "array",
"description": "List of markers to add",
"items": {
"type": "object",
"properties": {
"timecode": {"type": "string"},
"name": {"type": "string"},
"marker_type": {"type": "string"},
"color": {"type": "string"}
},
"required": ["timecode", "name"]
}
},
"auto_detect": {
"type": "object",
"description": "Auto-generate markers based on detection",
"properties": {
"at_cuts": {"type": "boolean", "description": "Add marker at every cut point"},
"at_keywords": {"type": "array", "items": {"type": "string"}, "description": "Add marker where keyword appears"},
"at_intervals": {"type": "string", "description": "Add markers at regular intervals (e.g., '00:00:30:00')"}
}
}
},
"required": ["project_path"]
}
}
apply_effect
{
"name": "apply_effect",
"description": "Apply a video or audio effect to one or more clips.",
"inputSchema": {
"type": "object",
"properties": {
"project_path": {
"type": "string",
"description": "Path to the FCPXML file"
},
"clip_ids": {
"type": "array",
"items": {"type": "string"},
"description": "Clips to apply effect to"
},
"effect_type": {
"type": "string",
"enum": ["color-correction", "lut", "blur", "sharpen", "stabilize", "denoise", "transform"],
"description": "Type of effect to apply"
},
"parameters": {
"type": "object",
"description": "Effect-specific parameters (varies by effect_type)"
}
},
"required": ["project_path", "clip_ids", "effect_type"]
}
}
generate_proxies_list
{
"name": "generate_proxies_list",
"description": "Analyze project and generate a list of source files that need proxy generation.",
"inputSchema": {
"type": "object",
"properties": {
"project_path": {
"type": "string",
"description": "Path to the FCPXML file"
},
"threshold_resolution": {
"type": "string",
"default": "1920x1080",
"description": "Flag sources above this resolution"
},
"output_format": {
"type": "string",
"enum": ["json", "csv", "shell-script"],
"default": "json",
"description": "Output format for the list"
}
},
"required": ["project_path"]
}
}
export_for_color
{
"name": "export_for_color",
"description": "Export timeline in formats optimized for color grading roundtrip (DaVinci Resolve, Baselight).",
"inputSchema": {
"type": "object",
"properties": {
"project_path": {
"type": "string",
"description": "Path to the FCPXML file"
},
"output_path": {
"type": "string",
"description": "Path for the exported file"
},
"format": {
"type": "string",
"enum": ["fcpxml", "edl", "aaf", "xml-resolve"],
"default": "fcpxml",
"description": "Export format"
},
"include_grades": {
"type": "boolean",
"default": false,
"description": "Include existing color adjustments"
},
"handle_frames": {
"type": "integer",
"default": 24,
"description": "Frames of handles to include for each clip"
}
},
"required": ["project_path", "output_path"]
}
}