DareDev256/fcp-mcp-server

View on GitHub โ†—

๐ŸŽฌ The first AI-powered MCP server for Final Cut Pro XML. Control your edits with natural language.

84 โ˜…19 forksPythonUpdated 19d ago

What you need to know

The bridge between Final Cut Pro and AI โ€” 7 grouped tools (62 underlying operations) turn FCPXML timelines into structured data Claude can read, edit, and generate: analyze, QC, markers, rough cuts, cross-NLE export, transcription, and live push-to-FCP.

Install

claude mcp add fcpxml -e FCP_PROJECTS_DIR=~/Movies -- uvx fcp-mcp-server
or add uvx fcp-mcp-server to claude_desktop_config.json; optional extras [intelligence,transcribe]

Usage

  • โ€ขexport XML from Final Cut Pro, ask Claude to work with the timeline (analyze, health check, fix flash frames/gaps, add chapter markers, build rough cuts), import the result back

Key features

  • โœ“7 grouped tools: inspect, diagnose, edit, mark, generate, transcript, deliver (62 flat handlers; FCP_MCP_LEGACY_TOOLS=1 re-advertises all 62)
  • โœ“QC: flash frames, gaps, duplicates, health score; auto-fix batch tools
  • โœ“markers/chapters: batch add, SRT/VTT import, YouTube chapters, beat import
  • โœ“generation: rough cuts, montages, A/B roll; templates
  • โœ“cross-NLE export: DaVinci Resolve v1.9, FCP7 XMEML v5 (Premiere/Avid); reformat 9:16/1:1/4:5
  • โœ“media intelligence: real silence detection (ffmpeg), beat detection (librosa)
  • โœ“transcript intelligence: local Whisper transcription, edit-by-transcript, filler-word removal
  • โœ“Live Mode (macOS): push_to_fcp via official Apple Open Document event, list_fcp_libraries; preview:// HTML timeline render
  • โœ“rational time arithmetic (zero rounding error), non-destructive edits, hardened security (defusedxml, sandboxed writes, 182 adversarial tests)

Best for

Video editors doing batch timeline ops, QC, transcript-driven cutting, and AI rough cuts around Final Cut Pro.

Caveats

  • โš not a plugin; runs on exported FCPXML (plus Apple-event push on macOS)
  • โš not for creative calls (color, framing, motion)
  • โš export path is manual File > Export XML
  • โš Python 3.10+; optional ffmpeg / librosa / Whisper extras
Platforms: macOS ยท Linux ยท WindowsClients: Claude Code ยท Claude Desktop

Reviewed 2026-08-11

Topics

aianthropicclaudefcpxmlfinal-cut-promcpmodel-context-protocolpythonvideo-editing
Stars
84โ˜…
Forks
19
Language
Python
License
MIT
Created
2026-01-18
Last push
2026-08-16