fcpxml-mcp-server 是一个 MCP（Model Context Protocol）服务器，用于处理 Final Cut Pro 的 FCPXML 时间线。它让 Claude 等 AI 客户端能够读取、编辑和生成真实的时间线，包括剪辑检测、标记、角色分配和基于转录的编辑。项目以 fcp-mcp-server 名称发布在 PyPI 上。
用途
该工具的核心思路是：从 Final Cut Pro 导出 XML，让 AI 处理批量、繁琐的编辑任务，再将修改后的 XML 导入回 Final Cut Pro。所有更改都是非破坏性的，原始文件不会被修改。它适合处理手动操作耗时的工作，例如统计剪辑点、逐个提取章节标记、逐帧查找闪光帧、逐片段构建粗剪等。
主要能力
- 查看时间线：view 工具以精确的有理数时间 JSON 返回时间线，支持 MCP Apps 的宿主可内联绘制泳道、缩略图、标记、转录词、播放头等。
- 编辑时间线：提供 15 个分组工具、102 个操作，涵盖修剪、分割、静音移除、基于转录和节拍的标记、粗剪、关键帧和速度斜坡、转录编辑、跨 NLE 导出，以及推送到正在运行的 Final Cut Pro。
- 可信操作：每次写入都记录日志并附带 sha256，可撤销；deliver 会拒绝未经审查的剪辑；expected_sha256 会拒绝在模型处理期间发生变化的文件；生成操作采用先报价后确认，并有每次调用上限。
- 安全：包含 182 个对抗性输入安全测试，全面使用 defusedxml，沙箱化写入，不使用私有 API，并提供披露渠道。
- 关键帧与速度曲线：inspect 和 edit 组包含五个视频/音频动画操作和三个速度曲线操作，可导入 Final Cut Pro 12.4 且无警告。
- 媒体智能与转录编辑：支持节拍检测和基于本地 Whisper 的转录编辑。
- Live Mode（macOS）：可将 FCPXML 直接推送到正在运行的 Final Cut Pro，无需重新导入 XML，使用 Apple 官方 Open Document 事件，不修补二进制、不使用私有 API、不使用辅助功能脚本。
- 预览：preview:// 资源和 preview_timeline 可渲染时间线；preview_check 会从源媒体采样生成胶片条和音频波形，用于确认剪辑是否正确。
- 生成式填充：gen 工具可填充间隙、添加 B-roll 或延长剪辑，采用先报价、后确认、再插入的固定顺序，并有每次调用费用上限。
使用方式
- 从 Final Cut Pro 导出 XML（File → Export XML…），打开 MCP 客户端，让 AI 处理时间线。
- 安装方式包括：Claude Code（最快）、项目级 .mcp.json、带媒体智能和转录编辑的配置、Claude Desktop 配置文件，或从源码安装。
- 调用采用分组形式：工具名是组名，操作放在 action 中，例如 {"action": "trim_clip", "args": {...}}。默认向 Claude 展示 15 个分组动词，而非 102 个扁平工具名。
- 可通过设置环境变量同时展示 71 个扁平 schema 和 15 个分组，共 86 个工具。
- 处理完成后，将修改后的 XML 导入回 Final Cut Pro（File → Import → XML）。
适用场景
- 音乐视频和连接剪辑：snap_to_beats 和 detect_flash_frames 可处理以音频床为基础、视觉元素作为连接剪辑挂在泳道上的时间线。
- 批量操作：健康检查、闪光帧检测、章节标记、粗剪、跨 NLE 导出和重格式化。
- 需要无补丁、可跨 FCP 更新、可信任处理客户库的场景。
限制
- 不是插件，不在 Final Cut Pro 内部运行。
- 不适用于创意决策，色彩、构图、运动仍需人工判断。
- Apple 使导入可脚本化，但不提供程序化导出；要取回当前时间线，仍需手动执行 File > Export XML。
- Live Mode 仅限 macOS，首次使用会触发一次性的 macOS 自动化权限提示。
- 生成式填充的提供商价格未经验证，且 runway 和 luma 的 video-to-video 功能报价但未实现。
- 部分操作（如 reorder_clips、rapid_trim、fix_flash_frames、fill_gaps）仅支持主故事情节。
- MCP Apps 内联时间线在 mcp 1.x 下无法通告扩展能力，需要 mcp 2.x 才能完成握手。
