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
- Stars
- 84โ
- Forks
- 19
- Language
- Python
- License
- MIT
- Created
- 2026-01-18
- Last push
- 2026-08-16