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，并在之后恢复之前聚焦的应用程序。
许可证
麻省理工学院
