MCP.Market

fcp-mcp — Final Cut Pro MCP Server

by dreliq9·io.github.dreliq9/fcp-mcp·v0.2.0·10 stars

Final Cut Pro MCP — 88 tools: FCPXML engine, live FCP control, media analysis, puppets.

A88/100grade A
What users say
No reviews yet
Be the first
Safety scan
A88/100

full report

Adoption
Growing

10 stars59 downloads/wk

Reviews

Write one

Nobody has reviewed fcp-mcp — Final Cut Pro MCP Server yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

fcp-mcp — Final Cut Pro MCP Server tools (88, 9 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • compressor_encode

    Encode a file using Compressor CLI.

  • compressor_list_settings

    List available Compressor encoding presets.

  • fcp_discover_effects

    List available FCP effects and transitions by scanning known locations.

  • fcp_export_xml

    Trigger XML export in FCP via menu automation (requires Accessibility permissions).

  • fcp_get_app_state

    Get FCP application state — version, frontmost status.

  • fcp_get_events

    Get events in a library (or all libraries if name not specified).

  • fcp_get_libraries

    Get all open libraries in Final Cut Pro (requires FCP to be running).

  • fcp_get_projects

    Get projects in an event (or all events if name not specified).

  • fcp_get_timeline_info

    Get info about the current/first timeline in FCP.

  • fcp_import_xml

    Import an FCPXML file into Final Cut Pro.

  • fcp_is_running

    Check if Final Cut Pro is currently running.

  • fcp_keyboard_shortcutwrite action

    Send a keyboard shortcut to FCP.

  • fcp_list_motion_templates

    List installed Motion templates (titles, transitions, generators, effects).

  • fcp_list_share_destinations

    List configured FCP share destinations.

  • fcp_menu_commandwrite action

    Execute any FCP menu command by path.

  • fcp_navigate

    Navigate to a specific timecode in FCP.

  • fcp_open_library

    Open a FCP library file.

  • fcp_playback

    Control FCP playback.

  • fcp_redo

    Redo the last undone action in FCP.

  • fcp_select_tool

    Switch FCP editing tool.

  • fcp_share

    Trigger a share/export from FCP.

  • fcp_undo

    Undo the last action in FCP.

  • fcpxml_add_audio

    Add an audio clip to the timeline.

  • fcpxml_add_keyword

    Add a keyword to a clip.

  • fcpxml_add_marker

    Add a marker to a clip.

  • fcpxml_add_title

    Add a title clip to the timeline.

  • fcpxml_add_transitionwrite action

    Insert a transition after a clip.

  • fcpxml_analyze_pacing

    Analyze shot pacing — average/median shot length, distribution histogram.

  • fcpxml_apply_template

    Apply an FCPXML template to a set of clips.

  • fcpxml_assign_role

    Set the role on a clip (e.g., "Dialogue", "Video", "Music", "Effects").

  • fcpxml_auto_rough_cut

    Auto-assemble clips into a rough cut timeline.

  • fcpxml_batch_add_markers

    Add multiple markers at once.

  • fcpxml_batch_apply_transition

    Add transitions between all adjacent clips in the timeline.

  • fcpxml_batch_assign_roles

    Assign roles to clips based on name matching rules.

  • fcpxml_batch_rename_clips

    Rename clips matching a pattern (substring replacement).

  • fcpxml_change_speed

    Change clip playback speed.

  • fcpxml_check_audio_levels

    Flag clips with potential audio issues (volume adjustments, missing audio).

  • fcpxml_check_duration

    Verify the timeline fits a target duration.

  • fcpxml_check_frame_rates

    Detect mixed frame rate issues in the timeline.

  • fcpxml_check_media_links

    Verify all referenced media files exist on disk.

  • fcpxml_check_safe_zones

    Check for clips with transforms that might push content outside safe zones.

  • fcpxml_create_projectwrite action

    Create a new empty FCPXML project file.

  • fcpxml_create_timelinewrite action

    Build a timeline from a list of clip definitions.

  • fcpxml_delete_clipswrite action

    Remove clips from the timeline by name.

  • fcpxml_detect_duplicates

    Find clips that use the same source media.

  • fcpxml_detect_flash_frames

    Find clips shorter than max_frames (potential flash frames / accidental edits).

  • fcpxml_detect_gaps

    Find all gaps in the timeline.

  • fcpxml_diff

    Compare two FCPXML files and show differences.

  • fcpxml_export_edl

    Export timeline as EDL (Edit Decision List).

  • fcpxml_export_fcp7

    Convert FCPXML to FCP7 XML format (compatible with Premiere Pro and Avid).

  • fcpxml_export_resolve

    Convert FCPXML to DaVinci Resolve-compatible format (FCPXML v1.9).

  • fcpxml_fill_gaps

    Replace all gaps in the timeline with clips from a specified asset.

  • fcpxml_fix_flash_frames

    Auto-fix flash frames by extending very short clips to minimum duration.

  • fcpxml_generate_montage

    Generate a montage/highlight reel with uniform clip durations and transitions.

  • fcpxml_import_edl

    Convert an EDL (Edit Decision List) to FCPXML.

  • fcpxml_import_srt

    Convert SRT subtitles to title clips and add to timeline.

  • fcpxml_list_clips

    List all clips in the timeline with timecodes, durations, and roles.

  • fcpxml_list_effects

    List all effects and transitions applied to clips.

  • fcpxml_list_markers

    List all markers, chapter markers, and keywords across all clips.

  • fcpxml_list_roles

    List all roles and subroles used in the timeline.

  • fcpxml_list_templates

    List available FCPXML template files.

  • fcpxml_parse

    Parse an FCPXML file and return a structure summary.

  • fcpxml_qc_report

    Generate a comprehensive quality check report for the timeline.

  • fcpxml_reformat

    Reformat a timeline for a different aspect ratio (e.g., 16:9 → 9:16 for vertical).

  • fcpxml_remove_silencewrite action

    Remove gaps longer than the threshold from the timeline.

  • fcpxml_reorder_clips

    Reorder clips in the primary spine to match the given name order.

  • fcpxml_save_template

    Save the current FCPXML structure as a reusable template.

  • fcpxml_split_clip

    Split a clip at a given offset within the clip.

  • fcpxml_timeline_stats

    Get comprehensive timeline statistics — duration, clip count, resolution, pacing, etc.

  • fcpxml_trim_clip

    Trim a clip's source in/out points.

  • fcpxml_validate

    Validate FCPXML structure and report errors/warnings.

  • media_audio_to_midi

    Transcribe audio to MIDI using basic-pitch (ML audio transcription).

  • media_detect_beats

    Detect beat positions in audio/music files.

  • media_detect_silence

    Detect silent sections in audio/video files.

  • media_extract_audio

    Extract audio track from a video file.

  • media_extract_thumbnail

    Extract a frame thumbnail from video at a specific time.

  • media_extract_thumbnails

    Extract thumbnails at regular intervals (contact sheet / storyboard).

  • media_info

    Get detailed media file info (codec, resolution, duration, bitrate, etc.).

  • media_list_streams

    List all audio, video, and subtitle streams in a media file.

  • media_loudness

    Analyze audio loudness (EBU R128 / LUFS).

  • media_scene_detect

    Detect scene changes in video.

  • puppet_animate

    Build a puppet scene with custom keyframe animations.

  • puppet_build_scene

    Build an FCPXML timeline from one or more puppet rigs.

  • puppet_create_humanoid_rigwrite action

    Create a standard 6-part humanoid rig from a folder of images.

  • puppet_create_rigwrite action

    Define a puppet character rig from body parts.

  • puppet_list_presets

    List all available puppet animation presets with descriptions.

  • puppet_multi_scene

    Build a multi-scene puppet animation with different presets per scene.

  • puppet_preset_motion

    Build a puppet scene with a preset motion applied.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan21 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 46 days ago12/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 88/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How fcp-mcp — Final Cut Pro MCP Server compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
88/100
higher than 75% of 48,255 servers
Tools
88
the typical server has 7
Tools that change things
10%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
10
more than 88% of 28,688 servers
Downloads a week
59
more than 48% of 12,191 servers with a package

What its tools let an agent do: 79 read · 9 change

Install fcp-mcp — Final Cut Pro MCP Server in Claude Code, Cursor or VS Code

claude mcp add fcp-mcp -- uvx fcp-mcp
Add to Cursor

What the publisher says

From the fcp-mcp — Final Cut Pro MCP Server repository's README, as published. We do not edit it. Read it on GitHub

fcp-mcp — Final Cut Pro MCP Server

<!-- mcp-name: io.github.dreliq9/fcp-mcp -->

Trusted, local, human-approved Final Cut Pro workflows. fcp-mcp inspects, generates, and transactionally edits FCPXML, then optionally hands verified artifacts to Final Cut Pro. The default profile never performs direct live or offline mutation.

Version 0.3.0 freezes a 94-tool catalog across four profiles. It is a bounded FCPXML interchange and tested Final Cut Pro handoff surface—not a claim of complete autonomous Final Cut Pro control. The default workflow is inspect, prepare, review, hash approval, then commit.

You: "Find and repair flash frames in hero.fcpxml."
Claude → fcpxml_detect_flash_frames → fcpxml_workflow_prepare
       → review semantic diff + candidate hash → fcpxml_workflow_commit
Result: the reviewed candidate is atomically committed with durable evidence

Start here:

  • Documentation index
  • First run
  • Compatibility
  • Support
  • Security
  • v0.3.0 release and fresh product evidence
  • Agent operating guide
  • Production workflow recipes
  • v0.3 changelog
  • v0.3.0 review evidence

Project Structure

fcp-mcp/
├── src/fcp_mcp/
│   ├── __init__.py
│   ├── __main__.py              # python -m fcp_mcp CLI
│   ├── cli.py                   # serve, doctor, doctor --json, --version
│   ├── config.py                # immutable environment configuration
│   ├── contracts.py             # stable errors + structured diagnostics
│   ├── diagnostics.py           # non-mutating runtime readiness checks
│   ├── observability.py         # text/JSON transaction events
│   ├── server.py                # MCP v2 entry and profile-selected handlers
│   ├── tool_metadata.py         # MCP safety annotation presets
│   ├── automation/
│   │   └── osascript.py         # argv-isolated AppleScript/JXA runner
│   ├── security/
│   │   └── paths.py             # allowed-root and output policy
│   ├── fcpxml/
│   │   ├── parser.py            # FCPXML → Python object tree
│   │   ├── writer.py            # transactional XML mutation/writing
│   │   ├── models.py            # TimeValue, Timecode, Clip, Timeline, etc.
│   │   ├── time_utils.py        # rational-arithmetic timecode
│   │   ├── analysis.py          # pacing, flash frames, gaps, duplicates
│   │   ├── validator.py         # DTD-style structural v

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

fcp-mcp — Final Cut Pro MCP Server: common questions

Is fcp-mcp — Final Cut Pro MCP Server safe?
Yes, by our scan: it is graded A (88/100). Read the fcp-mcp — Final Cut Pro MCP Server safety report
How do I install fcp-mcp — Final Cut Pro MCP Server?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does fcp-mcp — Final Cut Pro MCP Server need an API key?
No secret keys are declared. It reads 1 setting from the environment.
Is fcp-mcp — Final Cut Pro MCP Server maintained?
The last commit was 83 days ago (2026-08-13). The latest release is v0.2.0.
How does fcp-mcp — Final Cut Pro MCP Server compare with other MCP servers?
safety score 88/100 (higher than 75% of 48,255 servers); tools 88 (the typical server has 7); tools that change things 10% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.