Final Cut Pro MCP服务器

MCP（模型上下文协议）服务器，通过AppleScript和JXA自动化提供Final Cut Pro的全面远程控制。支持99种工具，涵盖编辑、人工智能功能、色彩分级、360/VR等。

需求

macOS 15.6+
Final Cut Pro 12.0+
Node.js 18+
系统事件的辅助功能权限（系统设置>隐私和安全>辅助功能）

设置

npm install
npm run build

Claude桌面配置

添加到您的Claude桌面 claude_desktop_config.json:

{
  "mcpServers": {
    "finalcutpro": {
      "command": "node",
      "args": ["/path/to/finalcutpro-mcp/dist/index.js"]
    }
  }
}

工具（共99个）

图书馆和项目检查

工具	说明
`get_libraries`	获取所有具有名称、ID、文件路径和事件计数的打开库
`get_events`	获取特定库中的所有事件
`get_projects`	获取事件中所有项目的顺序/时间线详细信息

项目管理

工具	说明
`new_library`	创建新库
`new_event`	在当前库中创建新事件
`new_project`	创建新项目
`close_library`	关闭当前库
`project_properties`	打开项目属性/设置检查器
`snapshot_project`	创建当前项目状态的快照（备份）
`duplicate_project`	使用不同的设置复制当前项目

播放和导航

工具	说明
`playback`	控制播放（播放/暂停、停止、从开始播放、选择、全屏、反转、循环）
`navigate`	时间线导航（跳转到开始/结束、下一个/上一个编辑/剪辑/标记/帧、向前/向后10帧）
`set_playback_speed`	设置播放速度（0.5倍至32倍，前进和后退）
`go_to_timecode`	导航到特定时间码位置

时间剪辑

工具	说明
`blade`	在游戏头位置切割/劈开夹子
`edit_insert`	插入介质（插入、追加、覆盖、连接、替换模式）
`delete_selection`	删除剪辑（波纹删除、用间隙替换、仅选择）
`clipboard`	复制、剪切、粘贴、粘贴连接
`selection`	全选、取消全选、选择播放头上的剪辑
`undo_redo`	撤消或重做操作
`trim`	修剪剪辑边缘（开始、结束、到播放头、延伸编辑、连接）
`nudge`	向任何方向轻扫剪辑
`insert_placeholder`	插入占位符或间隙夹
`create_compound_clip`	从所选内容创建复合剪辑
`create_storyline`	创建/折叠/提升连接的故事线
`change_duration`	打开更改持续时间对话框
`rename_clip`	重命名所选剪辑
`detach_audio`	将音频与视频分离，创建单独的剪辑
`merge_clips`	将相邻剪辑合并为一个
`break_apart_clip`	将复合/多芯夹子分解成组件
`adjustment_layer`	在当前剪辑上方添加调整层
`anchored_storyline`	创建和管理锚定的故事情节脊椎

效果与过渡

工具	说明
`add_transition`	添加默认交叉溶解过渡
`add_effect`	添加默认视频或音频效果
`add_color_correction`	添加颜色校正（色板、轮子、曲线、HSL、HDR等）
`add_title`	添加标题（基本标题，下三分之一）
`manage_effects`	复制/粘贴/删除效果和属性
`add_mask`	添加遮罩（形状、颜色或AI对象遮罩）
`effect_presets`	保存和管理颜色/视频/音频效果预设

AI/机器学习功能

工具	说明
`object_tracking`	使用神经网络的AI对象跟踪和分割掩模
`cinematic_editor`	用于iPhone cinematic视频焦点决策的AI电影模式编辑器
`detect_beats`	用于音乐/音频的AI自动节拍检测和节拍网格
`transcribe_to_captions`	AI音频转字幕转录
`auto_reframe`	针对不同宽高比的AI自动重帧
`image_playground`	苹果用于生成/编辑图像的AI图像游乐场

速度/重定时

工具	说明
`retime`	更改剪辑速度（慢速50/25/10%，快速2x/4x/8x，反转，冻结，保持，斜坡，倒带）
`retime_quality`	设置重定时质量（正常、帧混合、光流、基于ML）
`show_retime_editor`	切换重定时编辑器面板
`speed_editor`	先进的速度刀片、自定义速度和一致速度

色彩分级

工具	说明
`color_board`	全彩板控制（颜色/曝光/饱和度选项卡、按钮、微调、重置）
`color_channels`	更改查看器颜色通道显示（全部、R、G、B、alpha）
`color_correction_nav`	在更正之间导航，从以前的剪辑中应用
`match_color`	匹配剪辑之间的颜色，以实现一致的分级
`compare_frame`	用于颜色校正的前后比较查看器

标记和关键字

工具	说明
`add_marker`	添加标记（标准、待办事项、章节、标准和编辑）
`delete_markers`	删除标记（已选择或在选择范围内）
`rate_clip`	对剪辑进行评分（最喜欢、不喜欢、拒绝）
`add_keyword`	应用关键字组（1-9）
`set_role`	设置剪辑角色（视频、标题、对话、音乐、效果）
`open_keyword_editor`	打开关键字编辑器面板

字幕和副标题

工具	说明
`captions`	标题操作（创建、添加/编辑、提取、拆分、解决重叠）
`import_captions`	导入字幕文件（SRT、SCC、ITT等）
`export_captions`	从项目导出标题

音频

工具	说明
`adjust_volume`	调整音量（向上、向下、归零、静音）
`solo`	独奏/非独奏剪辑音频
`audio_operations`	增强音频、匹配音频、与视频对齐、淡入淡出、交叉效果
`audio_fade_management`	删除渐变、横向对齐的剪辑

关键帧动画

工具	说明
`keyframes`	添加、删除、复制、剪切、粘贴关键帧；在关键帧之间导航；微调值

变体/试听

工具	说明
`variants`	创建、导航、最终确定和分组剪辑变体/试听

迷彩

工具	说明
`switch_angle`	切换多播角度（1-16，带切割和切换选项）
`create_multicam_clip`	从所选内容创建多播剪辑

360/VR/空间视频

工具	说明
`spatial_video`	立体模式（左眼/右眼、补色、差异、叠加）、360度导航（倾斜、平移、滚动）、视场控制、地平线显示、头戴式显示器锁定

工具和界面

工具	说明
`select_tool`	切换编辑工具（选择、修剪、刀片、位置、手、缩放、范围、裁剪、扭曲、变换、电影）
`toggle_snapping`	切换时间线捕捉
`toggle_panel`	显示/隐藏面板（检查器、时间线、效果浏览器、视频范围、音频仪表、精度编辑器等）
`zoom_timeline`	缩放时间线（放大、缩小、调整、垂直调整、子帧）
`window_layout`	切换窗口布局预设（默认、组织、颜色和效果、双显示器）
`go_to_panel`	将焦点导航到特定面板
`clip_appearance`	更改剪辑显示样式（仅标题、波形、缩略图等）
`av_edit_mode`	设置A/V编辑模式（两种模式，仅视频，仅音频）
`timeline_history`	浏览时间线层次结构（关闭当前、关闭其他、显示祖先）
`video_output`	切换外部A/V输出以进行广播监控
`custom_overlay`	切换自定义覆盖显示（安全区等）

媒体组织

工具	说明
`reveal_in_finder`	在Finder中显示源媒体
`transcode_media`	打开转码对话框
`consolidate_files`	整合媒体文件
`relink_files`	重新链接原始或代理媒体
`analyze_and_fix`	运行分析并修复剪辑
`synchronize_clips`	同步剪辑（对齐音频/视频）
`duplicate_detection`	查找和导航重复剪辑，使剪辑独一无二

进口/出口

工具	说明
`import_media`	打开导入媒体对话框
`import_xml`	导入FCPXML文件（按路径或对话框）
`export_xml`	将项目/事件导出为FCPXML
`share`	共享/导出项目（默认目的地或压缩机）
`render`	渲染时间线（全部或部分）

FCPXML生成

工具	说明
`generate_fcpxml`	通过编程生成带有剪辑、过渡、标题和效果的FCPXML 1.11

通用命令执行

工具	说明
`execute_menu_command`	按路径执行任何FCP菜单命令
`send_shortcut`	将任何键盘快捷键发送到FCP
`find`	打开“查找”对话框或查找并替换标题

运作原理

服务器通过三种机制与Final Cut Pro通信：

JXA（JavaScript自动化） -通过FCP的AppleScript字典进行库/事件/项目检查的只读查询
带有系统事件的AppleScript -用于编辑操作的菜单导航和键盘快捷键
FCPXML -通过FCP的XML交换格式创建程序化时间线

服务器自动管理FCP焦点——它在需要FCP的命令之前激活FCP，并在之后恢复之前聚焦的应用程序。

许可证

麻省理工学院

Final Cut Pro MCP Server

快速接入

详细介绍