MCP for Adobe Premiere Pro

这是什么？

Adobe Premiere Pro MCP 是一款独立的、采用 MIT 许可证的本地 MCP 服务， 由 leancoderkavy/premiere-pro-mcp 以 premiere-pro-mcp 名称发布。安装此软件包及其独立的 Premiere 连接器，即可将兼容的 AI 助手连接到受支持的项目检查、时间线编辑和导出工具。 请先运行 verify_premiere_connection，确认桥接正常后再进行任何更改。

查找合适的 Adobe Premiere Pro MCP 指南

一个 MCP（模型上下文协议） 服务，可让 Claude、Windsurf、Cursor、GitHub Copilot 等 AI 助手或任何兼容 MCP 的客户端直接控制 Adobe Premiere Pro——导入媒体、编辑时间线、应用效果、管理关键帧、导出等。

"Add the B-roll clips to V2, apply a cross dissolve between each, color correct them to match the A-roll, and export a 1080p ProRes."

一览

本项目独立开发，与 Adobe Inc. 无关联，也未获得其认可。 本项目也独立于其他 Premiere Pro MCP 服务。此仓库发布的唯一 npm 包是 premiere-pro-mcp，其他包名均无法安装此项目。

在比较名称相似的包？ 此包和 adobe-premiere-pro-mcp 都声明了 premiere-pro-mcp 可执行文件。配置客户端前，请先核实包和仓库。新的本地配置助手会输出可直接指向此安装的 Claude、Cursor、VS Code 或 Codex 设置。此功能包含在 v1.15.1 及更高版本中。

当前源码为受支持工作流步骤提供 444 个核心工具，涵盖受支持的 ExtendScript、QE DOM、本地媒体与交换格式分析、带修订版本的项目上下文检索、安全编辑规划、项目导入预览、审核交接、连接验证，以及受保护的 After Effects MOGRT 制作、批处理、库管理、渲染队列、检查和 Premiere 交接工作流。兼容且已通过身份验证的 UXP 面板还会增加 96 个有文档说明、受能力限制的工具，而不会替换生产 CEP 桥接程序。

最新版本：1.25.0

已发布的 v1.25.0 npm 工件包含 441 个核心工具，默认配置中有 439 个；连接兼容的 UXP 后则有 535 个。上方的开发目录可能包含尚未发布的功能。请参阅版本事实与包来源。

GitHub 发布版的标题和标签均使用 v<SemVer> 格式，例如 v1.25.0。 请参阅发布命名与版本约定。

试用有界工作流

选择设置指南：Claude Desktop、 Codex、 其他本地 MCP 客户端， 或 ChatGPT 连接选项。

下载工作流入门套件，获取合成媒体和三个评估方案：只读序列检查、经明确确认后导出审核帧，以及产品短片预览。无需提供电子邮件地址。此套件没有录制的 Premiere 演示或经过验证的主机结果。请从一个临时项目开始；如果连接不可用，请使用设置与恢复指南。

版本亮点

• **1.24.0 标记写入修复：**临时覆盖标记和恢复的项目项标记会在刻度边界之后四分之一媒体帧处写入，因此在 unnest_sequence、replace_clip 和 duplicate_clip 中，Premiere 26.5.2 不再将它们向下取整到提前一帧的位置。

• 1.24.0 字幕样式指南：get_caption_style_guidance 接受范围受限的 custom_style，并返回“属性”面板和“轨道样式”的操作步骤；它仅提供指南，不会应用任何设置。

• **1.23.0 范围受限的工作流：**新增 41 个核心工具和五条引导式路径，涵盖精确时间线规划、编辑审查、交换与交付，以及受保护的交付流程。52 项实施清单记录了每个受支持的子集和宿主限制。

• **1.23.0 执行与恢复：**协同进程会串行执行受保护的编辑操作，在结果不确定时保留恢复信息，并明确报告取消或部分完成的情况。UXP 写入需要搭配相应的更新版面板；较旧的无版本面板仍为只读。

• **1.23.0 工件证据：**审查和交付检查会固定源校验和，检查实际解码的画面和音频，并保留对原生任务完成情况的未知状态。本地解码器检查无法证明 Premiere 播放正常或支持原生格式往返兼容。

• **1.23.0 导入修复：**文件夹导入会验证实际的项目项回读；字幕导入会验证格式和数量，并保留变更回读。导出预设发现会避开代理素材导入预设；取消嵌套会拒绝存在混合媒体覆盖风险的操作。

• **1.22.0 回读收据：**效果写入、稳定处理、智能素材箱、代理、文件夹导入、序列创建、标记删除和剪辑选择会报告 Premiere 实际应用的结果：verified、committed_unverified 或 failed；create_subclip、add_title 和 update_marker 会报告已存储的值；set_sequence_frame_rate 会列出被 Premiere 重新吸附到帧网格的剪辑。

• 1.22.0 显示代码和代理：set_sequence_display_format 会写入 Premiere 的实际显示代码（视频为 100-113，音频为 200-201），并将旧版 0-11 和 0-1 输入映射到这些代码；manage_proxies 的切换操作可设置已知的代理显示状态；Windows ACL 检查最多等待 30 秒以等待 PowerShell。

• **1.21.0 Claude Desktop 启动修复：**可选设置为空时，扩展仍会启动；Desktop 的仅发现探测不再占用 UXP 端口，因此实际 MCP 服务会保留其 UXP 工具。

• **1.21.0 帧网格验证：**项目项标记、序列 In/Out、工作区、链接/取消链接、零点、转场、replace_clip 和 duplicate_clip 均会按照 Premiere 自身的帧网格和采样网格进行验证，并在不确定时安全失败；UXP 工具会将时间吸附到序列帧网格。

• 1.20.0 经验证的范围移除：ripple_remove_timeline_ranges 会先预览，再使用一次性确认令牌执行多范围波纹移除，并提供剪辑级回读（QE 刀片；实验性）。

• **1.20.0 效果安全性：**效果颜色可无损读取和写入；除非提供 property_index，否则会拒绝含义不明确的属性名称（例如重复的 Lumetri 控件）；duplicate_clip 复制的剪辑会保留原始长度。

• 1.20.0 导入与元数据新增功能：import_fcp_xml 可导入到已打开的项目中；import_folder 接受 target_bin；get_encoder_presets 可通过 limit/offset 分页；set_footage_interpretation 可设置 field_type；通过 import_media 导入 XML/AAF/EDL 时不再报告错误。

• **1.19.1 时间线修复：**有界序列分页支持续页、测量未链接剪辑的兼容性，并加快波纹移动；大幅编辑需显式启用，宿主等待时间会按比例调整。

• **1.19.1 更安全的交接：**AME 全队列启动需要显式启用；格式错误的 MOGRT 文件会在导入宿主前被拒绝；对于结果不确定但已提交的编辑，会保留检查指南。

• **1.19.1 转录与采集修复：**为空的宿主关联转录可以接受受保护的导入；已存储的值和静帧文件无法证明动画随时间变化。评估关键帧曲线需要导出一段实际的短视频。

• **编辑策划：**影片素材取证、转录稿清理、字幕编写、短视频与章节规划、节奏和说话人布局、时间线 QA，以及平台交付计划。

• **跨应用交接：**具备能力感知的工作流路由，以及受保护的 After Effects 渲染到 Premiere 交接流程。

• **编辑正确性：**对转场、导入、效果、源素材身份和轨道操作进行验证回读，并明确报告能力不支持或已提交但未经验证的失败。插入编辑会让 QE 同步锁定的轨道波及更新，而不是悄悄造成邻近素材失步。

• **MOGRT 工作室：**可选的独立 After Effects CEP 连接器可以 创建需审批的标题、标注、引言和社交媒体模板方案；使用本地品牌套件进行约束； 批量处理、发布、排队、检查，并将其交接给 Premiere，但不会声称已提供视觉验证或渲染完成证明。

• **全局更新交接：**全局 npm 安装可在 Windows CEP 面板中显示其服务和 连接器的更新状态，并且只有在明确确认后，才会在退出 Premiere 后更新； 它绝不会更改项目、客户端配置、源代码检出目录或自定义 npm 前缀。

• **本地审核规划：**字幕时间预览会解析调用方提供的 SRT/VTT，而不会写入或导入；与修订版本关联的编辑证据则保留在选择启用的本地上下文索引中，不会调用提供方。

• 修复预览：premiere-pro-mcp --doctor --plan-fixes 会生成保护隐私且不写入内容的修复计划；符合严格条件的连接器修复仍需明确确认 Premiere 已关闭。

• **可审计指南：**通用设置指南、生成的公开工作流清单和验证操作手册，可让工作流与验证边界清晰可查，而不会声称已完成需许可主机的操作演示。

• **更快、更清晰的交付：**在无状态请求间安全复用不可变的 MCP 注册信息；网站新增了更轻量、优先适配移动设备的工作流视图，以及适用于公开页面的最新机器可读事实与爬取指南。

• **明确的边界：**托管端点仍是由操作员管理的 MCP 服务；未通过身份验证的调用方会被拒绝，且该服务不会将用户与本地 Premiere 进程配对。请参阅生成的支持操作目录，了解各项功能和验证契约。

完整详情请参阅 v1.25.0 发行说明。在 Premiere Pro 中进行实时安装仍需在宿主环境中验证。

当前 MCP 协议支持

该服务使用稳定版 TypeScript SDK v2，并通过 HTTP 和 stdio 提供 2026-07-28 无状态协议，同时保留对旧版 MCP 的兼容性，最高支持 2025-11-25。现代客户端可获得发现功能、经过验证的路由标头、 缓存提示、订阅流支持，以及正式的 Premiere 扩展能力。请参阅完整的 MCP 能力与边界报告。

如果 MCP 客户端无法完成其 server/discover 探测，请在该客户端的服务环境中设置 PREMIERE_MCP_PROTOCOL_MODE=legacy，然后重启客户端。这只会使用 SDK 的基础 stdio 传输和旧版初始化握手；若要使用现代 MCP 功能，请保持该变量未设置（或设为 auto）。

保护多项目 CEP 会话

每个已注册工具都接受可选的 expected_project_path，即目标已保存 Premiere 项目的绝对路径。生成的 CEP 脚本会在执行工具主体前，比较当前活动项目经宿主规范化后的文件路径；如果项目不同、缺失或尚未保存，脚本会拒绝执行，且不会运行工具主体。该保护仅适用于当前请求，并会针对多命令工具生成的每条命令进行检查。省略此参数可保留现有行为。

{"name":"get_project_info","arguments":{"expected_project_path":"/Projects/Film.prproj"}}

此保护可防止意外切换活动项目，但无法防止不安全脚本中故意切换项目。它不会选择项目，也无法证明媒体身份。路径会保留在请求上下文中，不会作为遥测数据发送。UXP 和 After Effects 命令不支持此 CEP 专用保护；UXP 工作流使用其 expected_snapshot 身份契约。本地工具不会检查 Premiere。文件系统别名不会被解析为项目身份的证明。

供评估 AI 工作流的剪辑师参考

在助手更改活动项目之前，请使用 Premiere Pro AI 工作流检查清单 定义目标和不做更改的边界，验证本地连接，请求一份范围明确的计划， 并检查返回结果。这是一个实用的起点，适合助手编辑和后期负责人在重复使用的工作流中 测试重复项目或小型测试序列。

如需了解产品背景，请参阅 Adobe Premiere AI 助手与 MCP 对比 和 Claude Desktop 设置指南。

如果你正在考虑使用单个本地项目、共享存储上的 Adobe Production，还是远程 Team Project，请先参阅 Premiere Pro 协作工作流 指南，再 评估 MCP 接入方式。该指南链接了相关的 Adobe 指南，不会请求检查项目， 并以相同的只读连接检查结束。

如需预览一个具体的 Project Intake，请从三个 通过架构检查且不含敏感数据的入门模板中选择一个。 这些模板仅供评估：机构使用前，必须由人工策略负责人审查并替换其中的 素材箱、媒体规则和组织规则。

快速入门

安装已发布的软件包（请核实名称）

npm i -g [email protected]

此仓库仅发布 premiere-pro-mcp。名称不同的软件包（adobe-premiere-pro-mcp）也可能声明 premiere-pro-mcp 可执行文件。配置客户端之前，请确认：

检查项	预期值
软件包名称	premiere-pro-mcp（不是 adobe-premiere-pro-mcp）
版本	1.25.0
主页 / 仓库	https://premiere-pro-mcp.com/ · https://github.com/leancoderkavy/premiere-pro-mcp

npm list -g premiere-pro-mcp
premiere-pro-mcp --version
npm view premiere-pro-mcp homepage repository.url

然后继续执行 --install-cep、--doctor，并使用只读的 verify_premiere_connection 提示词。

最简单的受支持方式：Claude Desktop

1. 下载最新的 Claude Desktop 安装包（.mcpb）。
2. 在 Claude Desktop 中，打开 Settings > Extensions > Advanced settings > Install Extension，选择下载的安装包，然后重启 Claude Desktop。
3. 下载单独的已签名 Premiere 连接器（.zxp）。使用可信的 ZXP 安装程序打开它。如果电脑上没有 ZXP 安装程序，请使用下方 Advanced setup 中的 npm 连接器安装程序。
4. 重启 Premiere，打开一个项目，然后打开 Window > Extensions > MCP for Adobe Premiere Pro。
5. 在 Claude 中输入：Safely check my Premiere connection with verify_premiere_connection. Make no changes.

Claude 安装包包含本地 MCP 服务，因此这条路径不需要 Node.js。Premiere 连接器需要单独安装。第一条提示词为只读操作，会报告服务是否已安装、已配置、已连接并通过实时验证。

首次编辑前，先进行首次验证

这是一个演示工作流，不是 Premiere 面板截图，也不能证明已连接到授权的主机应用。

1. 在 Premiere 中打开一个测试项目的副本和一个活动序列。
2. 打开 Window > Extensions > MCP for Adobe Premiere Pro。“Running”表示本地面板桥接可用；这并不表示编辑已完成。
3. 运行 premiere-pro-mcp --doctor，仅检查本地软件包和配置是否就绪。
4. 请 AI 客户端运行：Run verify_premiere_connection. Make no changes. 返回的检查为只读操作，且不会涉及项目名称、路径或媒体详情。

如果缺少桥接、项目或活动序列，请先修复相应的设置，再允许执行修改操作。如需查看这条路径的精简可译版本，请参阅英语、西班牙语和日语快速入门。这些译文是机器辅助生成的草稿，命令名称保留英文。

其他 AI 助手

Cursor、VS Code/Copilot、Windsurf 和其他 MCP 客户端目前没有项目提供的一键安装程序。请使用其 MCP 设置，并按照下方 npm 方式进行高级安装。请确保助手、服务、连接器和 Premiere 位于同一台电脑上。

如需下载并附加到任意 AI 助手的便携参考文档，请参阅 面向 AI 助手的 MCP for Adobe Premiere Pro 设置指南。 附加该指南可以为助手提供上下文；本地服务和 Premiere 连接器仍需分别安装。

npm install -g premiere-pro-mcp

git clone https://github.com/leancoderkavy/premiere-pro-mcp.git
cd premiere-pro-mcp
npm install
npm run build

premiere-pro-mcp --install-cep

npm run install-cep

premiere-pro-mcp --doctor

新的发行版本会更新本地服务和 Premiere 连接器；部署托管 MCP 服务不会替换你计算机上的软件。更新连接器前，请完全退出 Premiere。

通过 npm 全局安装：

premiere-pro-mcp --check-update
premiere-pro-mcp --update

--update 只会更改 npm 全局安装。它会安装已发布的 latest 版本，刷新捆绑的 CEP 连接器，并保留 MCP 客户端配置和项目不变。之后重启 Premiere 和 MCP 客户端，并在编辑前运行 verify_premiere_connection。

通过 MCP for Adobe Premiere Pro 面板安装（Windows npm 全局安装）：

MCP 更新卡片会将已安装的全局服务和连接器与 npm latest 版本进行比较。选择退出后更新，查看确认信息，然后正常退出 Premiere。按用户安装的辅助程序会等待 Premiere 退出；它绝不会强制退出应用，然后安装已发布的 npm 包并刷新与之匹配的连接器。这也支持早于 --update 命令的旧版全局安装。 重新打开 Premiere 后，面板会报告结果，并提醒你重启 MCP 客户端并验证连接。此流程不会更改项目或 MCP 客户端配置。它不会更新 Git 检出版本、自定义 npm 前缀或 Claude Desktop .mcpb 捆绑包。

通过 Git 克隆安装：

npm run check-update:source
npm run update:source

源代码更新程序会拒绝更新包含未提交文件或本地提交的检出版本，只会快进到其配置的上游版本，然后运行 npm ci 和生产构建，最后刷新 CEP 连接器。这样可以避免静默覆盖本地代码。如果你安装的是 Claude Desktop .mcpb 捆绑包，请改为从 GitHub 发行版本下载并安装更新的捆绑包；扩展更新由 Claude 控制。

移除 CEP 连接器

完全退出 Premiere，然后仅移除此连接器：

premiere-pro-mcp --uninstall-cep

卸载程序会有意保留 Adobe 的共享 PlayerDebugMode 设置，以免影响其他 CEP 扩展。从 AI 客户端配置中移除 MCP 服务；如果不再使用，也请单独卸载 npm 包。在 macOS 上，--uninstall-cep 会移除按用户安装的 npm/源代码版本；签名的系统范围 .pkg 安装方式有单独的特权移除命令，详见发行就绪情况。

发布到 npm

最简单、可重复的方式是使用无需令牌的 GitHub Actions 工作流：

1. 在 npm 包设置中，将 GitHub Actions 配置为 leancoderkavy/premiere-pro-mcp 和工作流文件 npm-publish.yml 的可信发布者。
2. 允许 npm publish 操作。
3. 打开 Actions -> Publish npm -> Run workflow，并保留默认的 latest 标签。

该工作流会安装依赖、构建、运行测试、验证打包文件，并拒绝重新发布已有版本，然后通过短期 OIDC 凭据发布，并自动生成来源证明。无需 npm 令牌或定期 OTP。

若要在本地发布，请使用引导式辅助工具：

npm run publish:npm

实用的本地选项：

npm run publish:npm:dry-run
NPM_OTP=123456 npm run publish:npm
NPM_TOKEN=npm_xxx npm run publish:npm

mkdir -p ~/Library/Application\ Support/Adobe/CEP/extensions
ln -s "$(pwd)/cep-plugin" ~/Library/Application\ Support/Adobe/CEP/extensions/MCPBridgeCEP

# Enable unsigned extensions (CSXS 9–14)
for v in 9 10 11 12 13 14; do
  defaults write com.adobe.CSXS.$v PlayerDebugMode 1
done

如果你通过 npm 安装，请将客户端配置为运行全局命令：

{
  "mcpServers": {
    "premiere-pro": {
      "command": "premiere-pro-mcp"
    }
  }
}

如果你改为克隆了此仓库，请使用下方针对你客户端的源码构建配置。

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

{
  "premiere-pro": {
    "command": "node",
    "args": ["/absolute/path/to/premiere-pro-mcp/dist/index.js"]
  }
}

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

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

4. 在 Premiere Pro 中验证桥接

1. 打开（或重启）Premiere Pro
2. 桥接会使用默认临时目录（或之前保存的设置）自动启动
3. 你也可以前往 Window > Extensions > MCP for Adobe Premiere Pro，确认绿色的“Running”状态，或将 Temp Directory 更改为与 MCP 客户端配置相符的目录
4. 在 Premiere 处于打开状态时，让你的 AI 助手依次运行 get_capabilities 和 ping。
5. 首次请求可选择安全的内容，例如：“我当前的 Premiere Pro 项目和活动序列是什么？不要进行任何更改。”

桥接目录在两端都根据操作系统确定，因此大多数本地配置都无需设置 PREMIERE_TEMP_DIR。在 macOS 上，即使通过 GUI 启动的客户端清除了 TMPDIR，服务仍会解析当前用户的系统临时目录，使其与 Premiere 的 CEP 面板保持一致。如果你覆盖此设置，请在 MCP 服务和 CEP 面板中使用相同的绝对路径；Windows 和 macOS 的路径不可互换。

Codex 插件

此仓库包含一个可安装的 Codex 插件，其中打包了本地 MCP 服务和一个以安全为导向的 Premiere 编辑技能。

从此仓库的克隆目录中运行：

codex plugin marketplace add .
codex plugin add premiere-pro@premiere-pro-mcp
npx -y [email protected] --install-cep

安装后，重启 Premiere Pro 并启动新的 Codex 会话。该插件会通过 npx 启动 [email protected]；由于 MCP 服务通过本地桥接与正在运行的 Premiere 主机通信，因此还需要单独安装 CEP。

插件源码位于 plugins/premiere-pro，仓库的市场清单位于 .agents/plugins/marketplace.json。

GPT-6 Astra 和 Agent 工具发现

如果你的账户有权限，请将 Codex 插件与 codex --model gpt-6-astra 搭配使用。服务会提供感知会话的工作流说明和有界的工具发现：调用 get_capabilities，并传入 {"tool_query":"transcript","tool_limit":10}，以查找相关操作、操作说明和后端要求。搜索默认仅涵盖在当前权限和工具包下注册的工具。

请参阅 GPT-6 Astra 工作流，了解证据检索、视觉审查、执行顺序，以及 MCP 与客户端能力的分工。

GPT-6 Sol 和 GPT-6 Luna

如果你的账户有权限，可将 Codex 插件与 codex --model gpt-6-sol 搭配使用，进行多步骤 Agent 编辑；或与 codex --model gpt-6-luna 搭配使用，进行聚焦的高容量检查。两者都在相同权限、预览和回读规则下调用相同的 MCP 工具。请参阅 GPT-6 Sol 和 Luna 工作流。

Claude

对于 Claude Code，请将此仓库添加为市场并安装插件：

/plugin marketplace add leancoderkavy/premiere-pro-mcp
/plugin install premiere-pro@premiere-pro-mcp

然后安装 Premiere 桥接并启动新的 Claude Code 会话：

npx -y [email protected] --install-cep

Claude Code 软件包位于 claude-plugins/premiere-pro，其市场配置文件位于 .claude-plugin/marketplace.json。

Claude Desktop 使用独立的 MCP Bundle（.mcpb）格式。使用以下命令构建并验证当前 Bundle：

npm run build:claude

通过 Settings > Extensions > Advanced settings > Install Extension，从 artifacts/ 安装生成的文件。Premiere CEP 桥接仍需单独安装。

Claude Fable 5.1

如果你的账户有权使用 Claude Fable 5.1（claude-fable-5-1），请搭配 Cursor、Claude Desktop 或 Claude Code 使用。模型选择由客户端负责；此服务不会运行 Anthropic 模型。Fable 5.1 为可选项：其他 Claude 模型也可以调用相同的 MCP 工具。如果启用了 Cursor Privacy Mode 或 Enterprise 计划，管理员必须先批准 Anthropic 的 Fable 数据保留政策，才能使用该模型。

该服务提供与会话相关的工作流说明和有限范围的工具发现：调用 get_capabilities 并传入 {"tool_query":"transcript","tool_limit":10}，即可查找相关操作、操作说明及后端要求。即使在较长的 Fable 5.1 会话中，也要按顺序执行 Premiere 修改操作。对返回帧的图像检查不能证明内容已播放或已交付。

请参阅 Claude Fable 5.1 工作流，了解连接顺序、隐私边界、证据检索、Cursor 的 Opus 回退方案，以及 MCP 与客户端功能的分工。公开指南见 如何将 Claude Fable 5.1 与 MCP 搭配用于 Adobe Premiere Pro。

Claude Opus 5.5

如果你的账户有权使用 Claude Opus 5.5（claude-opus-5-5），请搭配 Claude Code、Claude Desktop 或 Cursor 使用。模型选择由客户端负责；此服务不会运行 Anthropic 模型。Opus 5.5 为可选项。按顺序执行 Premiere 修改操作，并在应用前预览。请参阅 Claude Opus 5.5 工作流。

Windows 和 macOS 功能覆盖范围

get_capabilities 会报告当前操作系统、临时目录、CEP/UXP 覆盖范围、启用的权限配置，以及仍需进行的实时宿主验证。它还会包含完整的 tools 目录，该目录由服务注册的工具生成，其中也包括当前权限配置禁用的工具。每个条目都会标明：

• 执行后端（local、CEP/ExtendScript、QE 或编排器）；
• 静态支持状态（supported、limited、experimental 或 unsupported）；
• 服务已知的最低 Premiere 版本；
• 所需权限，以及当前配置是否启用了该权限；
• 验证边界，以及是否需要实时 Premiere 宿主；以及
• 相关操作说明。

由 QE 支持的工具会标记为 experimental，因为 QE 没有文档说明，且在不同 Premiere 构建版本之间可能有所差异。权限可用性与实现支持情况会分别报告，因此，例如禁用 edit 不会导致编辑工具被错误标记为不受支持。静态元数据绝不会声称 Premiere 操作已成功；请使用 ping，并检查每个工具的结果以获取运行时证据。

MCP tools/list 会根据当前权限配置进行筛选。默认的 inspect,edit,export,filesystem 配置会公开 369 个已注册工具中的 367 个，并省略需要 显式 unsafe-script 权限的 execute_extendscript 和 evaluate_expression。 在所有配置下，ping 和 get_capabilities 都会保持可见，以便受限或配置错误的服务仍能说明自身状态。即使列表元数据有误，调用时的功能防护仍具有最终效力。

按工作流划分的发现工具包和结构化输出

默认情况下，完整的许可目录仍然可用。将 PREMIERE_MCP_TOOL_PACKS 设置为 essential、inspection、delivery、captions，或用逗号分隔的组合（例如 inspection,captions），即可缩减工具发现范围和已注册的会话界面，供专用客户端使用。full 是显式的完整目录模式，不能与其他工具包组合使用。ping 和 get_capabilities 仍会列出以供诊断，且每次已注册的调用都会经过相同的功能防护；工具包不会授予权限。

现在，每个列出的工具都会通过 MCP outputSchema 声明相同的机器可读结果封装：成功时包含 ok、tool 和 data，失败时包含 ok、tool 和 error。 具体工具的 data 结构仍由各个工具结果单独进行版本管理，因此客户端无需解析文本块，即可可靠地区分传输成功与 Premiere 或本地操作失败。

After Effects MOGRT 工作室

这是一条范围有限的创作路径，并非通用的 After Effects 脚本运行器。 安装单独的本地连接器，彻底重启 After Effects，然后打开 窗口 > 扩展 > MCP for Adobe After Effects：

premiere-pro-mcp --install-after-effects-cep

然后在经批准的工作区内打开已保存的 .aep 项目，并按以下顺序操作：

1. verify_after_effects_connection — 只读检查连接器和已保存的项目。
2. preview_mogrt_recipe — 为五种受支持的配方之一生成一个会过期的一次性计划：lower_third、title_card、callout、quote_card 或 social_end_card；此操作不会创建目录，也不会联系 Adobe。
3. 使用该令牌和 confirm_export: true 调用 create_mogrt_recipe — 创建一个合成、保存已打开的项目，并请求导出一个 .mogrt 文件。
4. verify_mogrt_artifact — 仅检查本地文件是否存在及其 ZIP 文件头。

可选的工作室路径保留相同的预览和确认边界：

• validate_mogrt_brand_kit 会验证本地名称前缀、强调色／文本颜色、字体请求、安全边距和位于工作区内的徽标值，然后才将它们传入配方。
• preview_mogrt_batch / create_mogrt_batch 会按顺序导出最多 20 条 JSON/CSV 记录；批处理遇到主机错误时会停止，且不保证回滚。
• preview_mogrt_library_publish / publish_mogrt_to_library 会在已存在的本地库下写入一个新的、不可变的 v001、v002……副本。
• inspect_after_effects_template_source 会在 AE 16.1+ 中返回源合成的尺寸、时长、字体、图层类型和控制器名称；inspect_after_effects_render_templates 则会列出已有队列项中的主机模板名称。
• preview_after_effects_render / enqueue_after_effects_render 会将一个精确的渲染任务加入队列，但绝不会启动渲染。preview_mogrt_premiere_handoff / apply_mogrt_premiere_handoff 会将内容导入到明确指定的空 Premiere 序列 MOGRT Verify - …，并读取插入项／控件描述信息。

创作连接器使用 AFTER_EFFECTS_MCP_TEMP_DIR（默认值：操作系统临时目录加上 after-effects-mcp-bridge），与 PREMIERE_TEMP_DIR 完全分离。该工具不会创建、替换或切换项目；它要求已打开的 AE 项目和输出目录都位于同一经批准的工作区内。导入／控件回读仍需在交付前检查渲染帧；请使用 capture_frame 或单独的经批准导出路径。

inspect_sequence_review_report 会根据 Premiere 时间线回读内容生成一份只读交接报告，涵盖序列结构、主轨道间隙、已禁用片段、静音轨道、标记时间和脱机源证据。它绝不会返回媒体路径；除非明确请求，否则会省略标记注释。该报告不能证明渲染像素、音频质量、字幕准确性、权利状况或编辑审批。

MCP 握手会从已安装的 package.json 读取 serverInfo.version，因此客户端收到的是实际运行的软件包版本，而不是单独维护的固定版本字符串。

具有混合执行边界的工具可以在注册时提供明确的操作元数据。这些元数据用于本地文件验证、静态功能支持报告，以及本地加 Premiere 混合验证，避免能力目录仅凭名称推断主机依赖。

协作与 AI 功能边界

get_advanced_feature_support 会返回一份机器可读的功能矩阵，涵盖 Productions、Team Projects、Frame.io、Media Intelligence、Generative Extend、Object Mask、字幕翻译、Speech-to-Text、Enhance Speech、Remix、编辑计划、Premiere AI Assistant、Generative Media 以及未来的本地语义索引。每项都包含明确的访问模式：direct、observable-only、artifact-import、external-provider、user-assisted、unavailable 或 planned。可传入可选的 Premiere 版本、目标后端、已确认的授权和网络状态，以评估前置条件，同时避免将其与 API 可用性混为一谈。该工具会区分有文档说明的 API、授权、网络前置条件、独立服务 API 和需用户协助的操作，不使用菜单自动化或私有 API。

报告工具本身在本地运行：它不会联系 Premiere，可通过当前 MCP 服务调用。每项功能还会单独报告其操作是否可通过生产环境的 CEP 传输调用。对于 Productions，在 UXP 主机执行实时能力协商之前，报告仅包含静态的后端／版本适用性。

• Productions 通过 UXP 提供有文档说明的只读状态，但生产环境的 MCP 传输仍为 CEP。
• Frame.io 需要单独进行身份验证的 Frame.io API 集成；仅有账户授权并不意味着可通过 Premiere 的 DOM 调用。
• UXP 中有文档说明了转录稿 JSON 的导入／导出，但未说明如何启动 Speech-to-Text。
• preview_transcript_edit_uxp 和 plan_transcript_rough_cut_uxp 提供了一个与修订版本锁定的转录稿编辑工作流。规划器会将选定的转录稿片段映射到重复序列中经过验证的 1x 放置位置，并生成按降序排列的拆分／移除指令；它不会声称 Adobe 提供原生的转录文本删除功能，也不会执行未经验证的破坏性编辑。
• 其余 AI 操作均需用户协助，或尚无有文档说明的公共 API 支持。工具会说明用户完成操作后可检查哪些内容，以及哪些工件的来源无法安全确认。
• 服务绝不会使用菜单自动化、私有 API、剪辑名称启发式判断或时长变化来证明某项 AI 操作已发生。

可复用的项目上下文

对于反复检查剪辑、转录稿、音频和时间线放置位置成本较高的项目，可调用 manage_project_context 并设置 action: "capture"。本地上下文引擎会为有界的活动序列快照建立索引，在持久化前对原生项目／媒体路径进行哈希处理，并返回彼此独立的源、时间线和组合上下文修订版本。使用 action: "enrich" 添加转录稿片段、镜头描述、音频观察结果或编辑备注；常规修剪和移动会更新时间线修订版本，而不会丢弃未更改的源分析。

使用 search_project_context 仅检索与当前编辑意图相关的证据。create_context_edit_plan 会返回一个不会修改内容的候选框架和过期状态保护；create_editorial_plan 会添加经过审核的组织、串联、粗剪和字幕工件路径，不会调用大模型或更改 Premiere。应用任何更改前，仍必须先解析精确对象，并通过所路由操作的预览／确认流程传入。有关存储控制、隐私边界和失效行为，请参阅项目上下文引擎指南；有关完整的审核与路由工作流，请参阅本地优先的 AI 编辑工作流。

已通过身份验证的 UXP 连接

MCP 服务可以接受本地 UXP 面板连接，并调用当前已实现的 UXP 命令：

PREMIERE_UXP_TOKEN="replace-with-a-long-random-secret" premiere-pro-mcp

自行生成该密钥，并在 UXP 面板中输入相同的值（Window → UXP Plugins，而非 CEP Connector）。仅使用 CEP 的配置无需使用令牌。监听器仅绑定到 127.0.0.1:7777，对 WebSocket 升级进行身份验证，要求进行带版本号的能力握手，关联并发请求，并在超时或断开连接时终止待处理的工作。设置 PREMIERE_UXP_PORT 可使用其他回环端口。 启用后，MCP 发现会包含 96 项受能力门控的 UXP 扩展。第一轮扩展涵盖效果、确定性时间线选择、批量选择、场景检测、代理/摄取、重新链接、元数据、色彩一致化、只读 Premiere/After Effects 环境检查、源监视器试听、存储以及最小权限工作区访问。第二轮新增项目面板选择、标记 CRUD、单事务可撤销的节拍网格标记应用、素材箱整理、序列设置、导入、类型化效果参数/关键帧、轨道项变换、原子化 J/L 分割编辑、SequenceEditor 时间线编辑、序列生命周期以及 AME 编码。第三轮从经过脱敏的事件日志、保守的 AME 终止回执、明确的主机就绪门控、安全的多项目会话、基于租约的增长媒体控制、带命名空间的工作流检查点、有界媒体健康维护、支持字幕的轨道静音状态、事务性源修剪/取景、受保护的序列范围更新、受保护的源媒体起始时间设置，以及受保护的源媒体帧速率/像素宽高比覆盖开始，详见第三轮工作流矩阵。有限的迁移范围还包括非波纹式所选项提升、原生视频转场列表和受保护事务、原生活动序列及显式 GUID 序列时间检查、无需文件系统枚举的可选已安装 MOGRT 目录检查、可选源 ID、分类和广泛内容类别的有界原生时间线结构检查、受保护的序列显示格式更新、有界原生项目面板树、双重读取的项目面板插入素材箱快照、受保护的空白/默认序列创建、有界原生项目面板架构/项目列元数据检查、带精确状态/回读保护的受保护直接项目面板元数据替换、带非字段级回读的受保护类型化项目元数据架构字段创建、对三个指定应用程序首选项的受保护直接更新、针对单个精确源片段的受保护转录 JSON 替换、直接读取活动轨道项身份、受保护的仅源滑移、受保护的连续三项滑动、受保护的仅追加时间线复制、受保护的连续同轨道波纹删除、根据单个时间线坐标解析的受保护源项目颜色标签、受保护的显式序列预览帧矩形更新、可选启用并进行有界双重解析的源媒体来源路径、带明确已附加路径披露的有界源代理就绪状态、受保护的静态效果参数 PointF x/y 更新、有界效果参数描述符目录、有界项目/序列 Object Mask 审计、使用调用方拥有的输入和刻度回读进行的原生 FrameRate/TickTime 帧对齐检查，以及对调用方拥有的规范刻度字符串执行的原生 TickTime 算术；但它不声称支持直接创建/删除空轨道、全局重做、播放验证、Object Mask 计数或视觉有效性、原子化项目面板元数据比较并设置、应用程序首选项撤销、已安装模板的可用性或兼容性、导入转录的持久化、覆盖存在/清除语义、路径存在性、源素材沿袭或权利、代理兼容性、常规或带关键帧的效果参数值回读、渲染帧正确性、关联项目同步，或经授权主机验证。单独的混合基准测试门控会在获得可复现的跨平台证据前禁用原生加速。另请参阅第一份稳定工作流矩阵、后续十项工作流矩阵、受保护滑移工作流说明、受保护滑动工作流说明、受保护复制工作流说明和受保护波纹删除工作流说明。仅当经过身份验证的本地 UXP 桥接已连接时，才会公布命令；主机能力握手仍是判断运行中的 Premiere 版本是否支持相关功能的权威依据。UXP 命令失败后绝不会静默地通过 CEP 重试，因为首次操作可能已部分成功。UXP 编辑要求命令架构/回执版本匹配、面板账本持久存储以及原生加密熵；在安装匹配的面板之前，较旧的无版本面板仍保持只读。 有界 UXP 迁移范围还通过 automate_effect_parameters_uxp 提供只读的动画 PointF 端点位移检查。它要求指定一个精确的组件和参数目标，以及严格递增的时间区间；会对原生端点值及其距离进行双重读取，并拒绝静态、格式错误或已更改的参数状态。它不会修改 Premiere，也不证明渲染外观、播放、持久性、撤销或授权主机行为。

有界 UXP 迁移范围还通过 automate_effect_parameters_uxp 提供受保护的静态 Color 效果参数 RGBA 更新。此类更新需要完整的双重读取快照、明确确认、有效的操作 ID、按参数串行处理、一次原生事务以及精确的原始组件回读。它们会拒绝随时间变化的参数，且不声称支持关键帧 Color 编辑、色彩管理、渲染外观、播放、持久性、撤销或授权主机验证。

有界 UXP 迁移范围还提供受保护的类型化项目元数据架构字段创建。它要求精确匹配经过检查的活动项目身份和不超过 12 KiB 的面板 XML、明确确认和操作 ID，并按项目串行处理此桥接的架构调用和面板替换调用。Adobe 未提供原子比较并设置操作或字段级架构 getter：原生接受以及面板 XML 已更改仅能作为证据，因此该命令始终返回 committed_unverified，且不声称字段存在、持久性、UI 结果、撤销、取消或授权主机验证。

面板现在请求访问操作员选择的单个工作区，而不是声明对整个文件系统的访问权限。调用基于路径的 UXP 工作流之前，请先在面板中选择文件夹。媒体、重新链接、预设、导出和 Source Monitor 文件路径必须位于该文件夹内；持久能力令牌和原生根路径绝不会通过 MCP 返回。授予文件夹后，基于路径的命令会通过该文件夹的 Entry 树解析每个原生路径，并将主机的 nativePath 与获准的根路径进行比较，因此指向工作区外部的符号链接或 junction 目标仍会被安全拒绝。如果无法遍历主机 Entry 且未提供解析器，这些命令将保持不受支持，CEP 回退仍是基于路径的兼容方案。

原生转录编辑从只读、锁定修订版本的规划流程开始。使用 get_clip_transcript_uxp 导出 Premiere 为源剪辑生成的转录， 从该 JSON 中选择源时间范围，并将其 SHA-256 修订版本传递给 preview_transcript_edit_uxp。预览会对范围排序并合并，返回 确认令牌，但不会更改时间线。Premiere 未公开任何有文档说明的操作， 可直接将已删除的转录文本转换为时间线剪切，因此在源到序列的映射和 有文档说明的重建路径通过实时主机验证之前，仍不会提供自动应用功能。 search_clip_transcript_uxp 提供只读发现功能，不会用外部转录引擎替代。

Premiere 26.2-26.3 主机还提供有文档说明的 UXP 工作流，用于修订版本化的项目 检查、经过验证的项目保存、基于预设的序列创建、OTIO/FCP XML 互换、转录语言发现、Object Mask 检测、Adobe Media Encoder 控制、 轨道重命名、子剪辑创建、稳定标记检查、Source Monitor 定位以及剪辑转录检测。 变更操作接受可选的幂等键，并返回明确的验证结果。命令矩阵和实时主机 验证范围请参阅 Adobe UXP 26.3 覆盖矩阵 和 UXP 能力 基础。 Premiere 表面注册表 分别跟踪 Premiere DOM、通用 UXP JavaScript、HTML/CSS、Spectrum、插件指南、UXP Hybrid C++、独立的 Premiere C++ PrSDK、CEP/ExtendScript、CEP 平台、QE 以及固定版本的竞品来源。详尽的通用 UXP JavaScript 清单根据 Adobe 固定版本的声明文件生成，而详尽的 Premiere 文档清单则跟踪 Adobe 实时站点地图中的每个页面。这样可以将声明和文档清单与实现和许可主机覆盖范围区分开来。

稳定工作流扩展新增了原生组件链效果、确定性时间线选择、复合选择批次、场景剪辑检测、代理/采集控制、受保护的离线重新链接、事务式项目/XMP 元数据、色彩与素材一致性预检、完整的源监视器试听，以及项目/Production 存储检查。有关确切的参数、撤销、确认和实时主机边界，请参阅稳定版 UXP 工作流矩阵。

架构

本地（stdio）：

┌───────────────┐   stdio (MCP)    ┌──────────────┐   File-based IPC   ┌───────────────┐
│  AI Client    │ ◄──────────────► │  MCP Server  │ ◄────────────────► │  CEP Plugin   │
│  (Claude,     │                  │  (Node.js /  │   .jsx commands    │  (runs inside │
│   Windsurf,   │                  │  TypeScript) │   .json responses  │  Premiere)    │
│   Cursor,     │                  └──────────────┘                    └──────┬────────┘
│   Copilot)    │                                                             │
└───────────────┘                                                             │ evalScript()
                                                                              ▼
                                                                       ┌───────────────┐
                                                                       │  Premiere Pro │
                                                                       │  ExtendScript │
                                                                       │  + QE DOM     │
                                                                       └───────────────┘

远程（HTTP/SSE — Fly.io）：

┌───────────────┐  HTTP+SSE (MCP)  ┌─────────────────────┐   File-based IPC   ┌──────────────┐
│  AI Client    │ ◄──────────────► │  MCP Server         │ ◄────────────────► │  CEP Plugin  │
│  (any MCP     │                  │  premiere-pro-mcp   │   .jsx / .json     │  (Premiere)  │
│   client)     │                  │  .fly.dev           │   shared volume    └──────────────┘
└───────────────┘                  └─────────────────────┘

1. AI 客户端调用 MCP 工具（例如 add_to_timeline）
2. MCP 服务生成兼容 ES3 的 ExtendScript，并在前面添加辅助函数
3. 脚本写入共享临时目录中的 .jsx 命令文件
4. CEP 插件轮询命令文件，并通过 CSInterface.evalScript() 执行
5. 结果 JSON 写入响应文件并返回给 AI

基于文件的 IPC 桥接简单可靠，无需网络套接字即可在 macOS 和 Windows 上运行。

inspect_unique_object_identity_uxp 是一条独立的只读原生身份检查路径。它会解析恰好一个项目项或序列，读取两次不透明的 UniqueSerializeable 身份，并在身份发生变化时拒绝操作；它不会保留该值，也不会将其视为编辑权限。有关其范围和验证边界，请参阅唯一身份工作流说明。

电影剪辑审阅

inspect_film_editorial_workflow 会验证捕获的身份及明确的源素材/场景覆盖范围，构建标记、串剪、剪辑线和节拍审阅材料，并报告与修订版本绑定的备注、VFX 状态、变更影响和交付例外。该工具执行本地检查；主机编辑和导出使用单独的受保护工具。请参阅用法、示例和剩余执行适配器。

经过审阅的助手剪辑工具现在可提供对白候选项决策、引文纸上剪辑 CSV、批量复制预览、同步证据分类，以及自有素材的 B-roll 审阅。这些是本地证据审阅，不是新的主机引擎。请参阅审阅工作流契约。

有关精确时间规划、恢复、作业观察、时序证据和设施工作流，请参阅 Filmcraft 改进台账。

工具（核心工具总数为 444；默认配置下为 442；连接 UXP 桥接后为 538）

完整的受支持操作目录列出了所有已注册的核心工具、两个受显式 unsafe-script 权限限制的工具，以及全部 96 个已认证 UXP 扩展工具及其当前操作或模式值。该目录由返回给客户端的同一 MCP 注册接口生成；下表是按工作流整理的简要概览。

发现与检查（10 + 10）

项目管理（27）

时间线与编辑（11 + 27 项高级工具）

Premiere Pro 26.3 兼容性： 某些安装会静默忽略 QE 结构编辑 （ripple_delete、razor/split）和现有效果参数写入。现在，这些工具会验证 生成的序列状态，并在验证失败时返回错误，而非虚报成功。对于结构编辑，请使用 create_sequence 和 add_to_timeline 将所需的源范围重建到新序列中。旧版 CEP 转场路径的目标是 qeClip.addTransition（而非 QE 轨道），并且只有在从 DOM 读取到转场数量后才会报告成功。有可用的已连接 UXP 转场工具时，请优先使用；当旧版 QE 写入被拒绝或无法验证时，叠加片段仍可作为变通方案。请参阅 问题 #21。

速度、字幕和视觉关键帧边界： Premiere Pro 26.3 可能会反映旧版 QE 速度／方向方法的结果，但没有受支持的脚本设置器或时间重映射组件可用于时间线片段的速度或方向（截至 26.3，文档中的 UXP 仅提供 getSpeed / isSpeedReversed）。reverse_clip、 speed_change、set_clip_speed_qe 和 set_clip_properties 中的 speed 现在都会在修改宿主前停止；若要更改时间线长度，请使用 set_clip_duration，或使用“速度／持续时间”UI 或预渲染媒体调整时间。add_text_overlay 同样会在 修改前停止，因为尚未提供从纯文本创建字幕的 API；请导入 .srt／.vtt 并使用 create_caption_track，或使用 MOGRT／PNG 叠加层。关键帧和字幕轨道的 响应只能证明参数／结构已被读回，不能证明渲染出的像素效果；交付前请验证播放效果 或导出的帧。在 macOS 上，AME 预设发现功能会扫描每个已安装应用程序 包的 Contents/MediaIO/systempresets；竖屏项目请优先使用“匹配源”预设。

宿主限制：功能能力清单区分了 不可用的 API、未经验证的宿主请求，以及属性／结构读回。 已验证参数或组件并不能证明最终渲染效果。

已验证的轨道编辑：add_track 和 add_tracks 会验证请求的数量，并且 只有在活动序列的轨道数量与请求完全一致时才会返回成功。 overwrite_clip 会验证所选轨道索引，并确认目标源素材出现在目标轨道上指定帧的位置。在忽略这些调用中任意一项的 Premiere 26.x 版本中， MCP 响应会根据观测到的状态返回错误，而非虚报成功。这些是自动化 CEP 契约检查，并不能证明某个特定的 已授权宿主配置。

trim_clip 每次调用只能接受一个相对于源素材的 new_in_seconds 或 new_out_seconds。它会拒绝调整过速度的片段，因为 CEP 无法证明其源素材与时间线之间的映射关系；随后，它会读取源入点和出点，以及可见的时间线起点／终点／时长，再报告成功。默认的 keyframe_policy: "reject" 会在修剪将导致效果关键帧超出片段可见范围时停止；keyframe_policy: "preserve" 是显式选择启用的选项，并会报告剩余数量。keyframe_policy: "hold_last_value" 也会保留这些关键帧，并使每个动画数值参数保持其边缘值：修剪到动画范围内时，会在新的边缘处以该位置采样到的值添加关键帧；延长到隐藏关键帧之外时，则会在旧边缘和新边缘处固定为旧边缘值。如果关键帧会因此显现，或某个值无法无损采样或写入，该选项会在修改前拒绝操作；并会在新边缘处读回每个值（若有值不一致，则返回 committed_unverified）。这里只验证边缘值；新增关键帧旁的贝塞尔曲线段可能会改变关键帧之间的曲线形状。split_clip 会验证片段跨越切点、数量按预期增加，以及左右两侧的切割边界。其 QE 路径无法证明效果关键帧是否正确重新分布，因此成功结果会将相关语义标记为 unverified。这些是 CEP 契约检查，并非在已授权的 Premiere Pro 26.x 宿主中进行的验证。 set_clip_duration 可在不直接触碰源素材入点／出点的情况下更改已放置剪辑的时间线长度：必须且只能传入 duration_seconds（从当前起点算起）或 end_seconds（时间线上的绝对终点）其中一个。它会将文档所述的 TrackItem.end 写入基于刻度的 Time；如果终点会与同一轨道上的下一个剪辑重叠，则会拒绝操作；缩短时会应用与 trim_clip 相同的 keyframe_policy 保护，并读回起点／终点。如果 Premiere 限制了终点（例如，视频素材没有剩余余量，或静帧的项目项设有入点／出点），则会还原原始终点并返回错误。不会调整链接的音频／视频配对剪辑。这是 CEP 合约检查，并非在已授权的 Premiere Pro 主机中进行的验证。

效果与颜色（8）

Premiere 26.x 组件移除： remove_effect 和 remove_effect_by_name 需要 CEP 的 Component.remove() 方法。部分 26.x 组件（包括 Essential Sound 的 Amplify）不提供此方法。这些工具会返回可执行的功能错误，并保持组件不变；请使用「效果控件」手动移除。QE DOM 没有安全的定向移除备用方案。

Essential Sound 音频自动化： Essential Sound 可能会将闪避或电平自动化写入 Amplify 组件，而不是剪辑的 Volume > Level。 adjust_audio_levels、set_clip_volume 和 get_clip_volume 仅操作 Volume > Level，因此不会读取、更改或验证 Amplify 自动化。在将 Volume 读回值视为剪辑的最终增益之前，请检查剪辑的组件（或「效果控件」）。

关键帧（8）

导出与编码（19）

文档所述的 Premiere UXP 通过运行时探测的 export_interchange_uxp 和 import_interchange_uxp 提供特定格式的 OTIO 导入／导出。CEP 没有文档所述的原生 OTIO 路径。通过受支持的自动化合约，原生 EDL、「渲染并替换」、云端发布和 Content Credentials 导出配置仍不可用。因此，export_sequence_edl 会根据 Premiere 读回的剪辑在本地构建 CMX 3600 列表，并使用 inspect_cmx3600_edl 所用的同一解析器进行验证；它并非 Premiere 原生导出。 get_capabilities 会明确报告尚存的交付功能缺口，而不会将仅限 UI 的操作说成可用工具。

源监视器与播放（7 + 4）

选择与剪贴板（7 + 7）

媒体属性（16）

序列管理（11）

工作区与字幕（2 + 1）

时间线 QA（2）

编辑器请求：标记、选择、检查点、导航（5）

审阅与对话规划（2）

这两种规划工具均在本地运行，结果确定。Premiere 未提供用于切换多机位源序列内角度的脚本 API，因此多机位规划针对的是堆叠在独立视频轨道上的同步片段，并通过检查点序列中的 razor_all_tracks、select_clips_in_range、batch_enable_disable 和 add_markers_batch 应用。请参阅编辑器请求，了解支持这些工具及其验证边界的社区和竞品证据。

说话者布局（2）

蒙版适配（1）

节奏规划（2）

Shorts 智能规划（2）

字幕编写（3）

Reaction Shorts（3）

转录词语编辑（4）

平台交付规划（2）

脚本编写（2）

……以及 100 多项工具

跟踪目标、批量操作、标记、音频电平、运动／变换、元数据、序列设置、导航、项目分析等。运行 get_project_info 即可开始 — AI 会发现所需信息。

MCP 资源

此服务提供十四项大模型上下文资源和十九个工作流提示词：

这十个 premiere:// 快照通过 CEP 桥接请求以只读方式获取。它们包含用于检测状态过期的修订令牌，并省略原生媒体、项目树、预设和输出路径。快照成功只能证明桥接读取正常，并不能证明获得了授权主机的功能覆盖、播放、渲染或编辑准确性。

远程部署（Fly.io）

服务器包含 HTTP/SSE 传输层（src/http-server.ts），可通过 mcp-remote 或任何支持 Streamable HTTP 的 MCP 客户端进行远程访问。

由运营方管理的 MCP 端点运行于 https://premiere-pro-mcp.fly.dev/mcp （健康检查：/health）。网站为 **https://premiere-pro-mcp.com**，由单独的代码仓库提供服务；Fly 主机上的其他路径会重定向至该网站。 该端点不是面向公众的桌面中继：它无法将已认证用户连接到该用户电脑上的 Premiere。在单独的设备配对中继可用之前，公众用户应使用本地 stdio 配置。

连接到运营方管理的实例

{
  "mcpServers": {
    "premiere-pro": {
      "command": "npx",
      "args": ["mcp-remote", "https://your-authorized-instance.example/mcp"]
    }
  }
}

该实例必须配置运营方 Bearer 令牌，或使用下方的 OAuth 资源服务器配置。生产端点会有意向未获授权的调用方返回 401。

在 Fly.io 上自托管

# Clone and deploy your own instance
git clone https://github.com/leancoderkavy/premiere-pro-mcp.git
cd premiere-pro-mcp
fly apps create your-app-name
# Required: add bearer token auth. Use a unique, high-entropy secret per deployment.
fly secrets set MCP_AUTH_TOKEN=your-secret-token
fly deploy --remote-only

然后使用以下方式连接：

{
  "mcpServers": {
    "premiere-pro": {
      "command": "npx",
      "args": ["mcp-remote", "https://your-app-name.fly.dev/mcp",
               "--header", "Authorization: Bearer your-secret-token"]
    }
  }
}

受信任运营方 OAuth 资源服务器模式

对于具备身份识别能力的运营方部署，请配置真实的 OAuth/OIDC 授权服务器，而不是分发 MCP_AUTH_TOKEN。授权服务器必须支持 MCP 客户端的注册模型，并为此 MCP 资源签发受众字段完全匹配的签名访问令牌。

fly secrets set \
  MCP_OAUTH_ISSUER=https://identity.example.com \
  MCP_OAUTH_JWKS_URI=https://identity.example.com/.well-known/jwks.json \
  MCP_OAUTH_AUDIENCE=https://your-app-name.fly.dev/mcp \
  MCP_PUBLIC_URL=https://your-app-name.fly.dev \
  MCP_OAUTH_REQUIRED_SCOPES=premiere:mcp \
  MCP_OAUTH_ALLOWED_SUBJECTS=your-provider-user-subject

OAuth 模式会验证令牌签名、算法、签发者、完全匹配的受众、过期时间、签发时间、主题和必需的范围。它会在 /.well-known/oauth-protected-resource/mcp 发布受保护资源元数据，并在 WWW-Authenticate 挑战中包含该 URL。配置采用失败即关闭策略：OAuth 设置不完整、生产环境 URL 非 HTTPS、OAuth/共享令牌设置存在歧义，以及凭据缺失，都会阻止服务启动。

MCP_OAUTH_ALLOWED_SUBJECTS 为必填项，它会将此单桥接部署限制为明确受信任的运营方身份。这是一道强制执行边界，并非面向公众用户的设备模型。

此模式可对受信任的运营方进行身份验证，但尚未实现设备所有权、桌面配对或按用户路由 Premiere。在实现出站桌面中继和持久化的用户/设备授权之前，请勿将编辑器修改功能作为面向公众的多用户服务公开。

**注意：**文件桥接仍要求 CEP 插件共享同一个 PREMIERE_TEMP_DIR。对于云部署，这意味着要运行同步 Agent，或使用 fly proxy / WireGuard 连接到本地计算机。 detect_silence 只能分析服务器文件系统中可用的媒体路径；仅在桌面上可用的路径不会自动在远程 Fly 机器上可用。 对于共享或多用户远程部署，请在服务器前部署受管的身份识别边缘层，并以按用户授权取代共享 Bearer 密钥。内置限流器有意设计为仅在进程本地提供纵深防御，不能替代边缘层/WAF 或账户系统。

环境变量

启用 PostHog 后，服务会记录 mcp_connection_attempt、 mcp_request、mcp_request_rejected 和 mcp_tool_call。只有在只读的 verify_premiere_connection 检查确认已选定桥接服务、项目已打开且序列处于活动状态后， 服务才会记录 premiere_mcp_activation_completed。事件包含有界的运维字段，例如方法、工具名称、结果、状态码、持续时间和所选桥接服务。 不会发送身份验证令牌、IP 地址、MCP 参数、项目路径、媒体名称和工具结果。此类事件已禁用人员资料。 此信号是汇总发出的信号，并不能证明分析服务提供商收到了它，也不代表唯一用户或编辑者的数量，亦不能证明编辑工作流已成功。它不包含人员或编辑者标识符，因此无法安全地推断“首次产生价值”。

项目结构

premiere-pro-mcp/
├── src/
│   ├── index.ts                 # Entry point — stdio transport setup
│   ├── http-server.ts           # Entry point — HTTP/SSE transport (Fly.io / remote)
│   ├── server.ts                # MCP server — registers 444 tools, filtered by authority profile
│   ├── bridge/
│   │   ├── file-bridge.ts       # File-based IPC (write .jsx, poll .json)
│   │   └── script-builder.ts    # ExtendScript generator with ES3 helpers
│   ├── tools/                   # 51 tool modules
│   │   ├── discovery.ts         # Project discovery and queries
│   │   ├── recovery.ts          # Read-only autosave discovery and private bridge telemetry
│   │   ├── project.ts           # Project management and import
│   │   ├── media.ts             # Media and proxy management
│   │   ├── sequence.ts          # Sequence creation and settings
│   │   ├── timeline.ts          # Timeline clip operations
│   │   ├── effects.ts           # Effect application and color correction
│   │   ├── transitions.ts       # Transition management (QE DOM)
│   │   ├── audio.ts             # Audio levels, keyframes, and ffmpeg silence analysis
│   │   ├── av-settings.ts       # Documented AV inspection, mapping, and capability boundaries
│   │   ├── text.ts              # Text overlays and MOGRTs
│   │   ├── markers.ts           # Sequence and clip markers
│   │   ├── tracks.ts            # Track add/delete/lock/visibility
│   │   ├── playhead.ts          # Playhead, work area, in/out points
│   │   ├── metadata.ts          # Metadata, XMP, color labels
│   │   ├── export.ts            # Export, frame capture, encoding
│   │   ├── advanced.ts          # QE DOM: ripple, roll, slide, slip, speed
│   │   ├── keyframes.ts         # Keyframe CRUD and interpolation
│   │   ├── scripting.ts         # Execute arbitrary ExtendScript
│   │   ├── inspection.ts        # Deep project/sequence/clip inspection
│   │   ├── selection.ts         # Clip selection utilities
│   │   ├── clipboard.ts         # Copy effects, batch operations
│   │   ├── source-monitor.ts    # Source monitor control
│   │   ├── track-targeting.ts   # Track targeting, motion, audio props
│   │   ├── utility.ts           # Batch ops, analysis, navigation
│   │   ├── health.ts            # Connectivity ping
│   │   ├── workspace.ts         # Workspace layout switching
│   │   ├── captions.ts          # Caption track creation
│   │   ├── playback.ts          # Timeline/source playback control
│   │   └── project-manager.ts   # Project consolidation/transfer
│   └── resources/
│       └── extendscript-reference.ts  # API reference for LLM context
├── cep-plugin/                  # CEP panel that runs inside Premiere Pro
│   ├── CSXS/manifest.xml        # Extension manifest (PPRO 14.0+)
│   ├── index.html               # Panel UI
│   ├── main.js                  # Bridge polling and script execution
│   ├── host.jsx                 # ExtendScript entry point
│   └── CSInterface.js           # Adobe CEP interface library
├── after-effects-cep-plugin/    # Separate AE CEP bridge for guarded MOGRT recipes
├── scripts/
│   ├── install-cep.sh           # macOS CEP installer (symlink + debug mode)
│   └── install-cep.ps1          # Windows CEP installer (copy + REG_SZ debug mode)
├── Dockerfile                   # Multi-stage Docker build for Fly.io
├── fly.toml                     # Fly.io deployment config
├── RESEARCH.md                  # API research and implementation status
├── AGENTS.md                    # IDE / coding-agent map
├── CONTRIBUTING.md              # Contribution guidelines
├── CHANGELOG.md                 # Version history
└── LICENSE                      # MIT License

技术详情

CEP 和 UXP 后端

CEP 仍是生产后端，因为它提供广泛的 ExtendScript 访问能力，以及用于在 Premiere Pro 2020–2026 中处理效果、波纹删除和高级修剪的未公开 QE DOM。打包的 uxp-plugin 是面向 Premiere 25.6+ 的预览后端，支持帧导出、功能发现和状态事件。它不会在 UXP 修改操作失败后悄悄改用 CEP 重试。

ExtendScript 兼容性

所有生成的脚本都使用 ES3 语法（var、手动 for 循环、不使用箭头函数、不使用 let/const），因为 ExtendScript 基于 ECMAScript 3。桥接程序会将带版本号的辅助库写入共享临时目录，并通过 $.evalFile 在每个 ExtendScript 引擎中加载一次；之后每条命令只发送其专用工具脚本。

安全性

元数据隐私：CEP 的 get_metadata 和 get_xmp_metadata 现在默认仅返回范围受限的解析字段，并省略 GPS、序列号、作者和联系信息。原始数据包必须显式设置数据包标志和 include_sensitive: true；源媒体路径必须设置 include_media_path: true。原本需要原始 XML 的现有调用方必须选择启用。磁盘上下文可能会保留名称、转录文本和备注；选择 PREMIERE_CONTEXT_BACKEND=memory 可避免持久化。

部署前请了解信任模型：任何能够访问 MCP 服务的客户端都可以控制 Premiere Pro。 execute_extendscript 和 evaluate_expression 按设计属于任意代码执行工具，默认不会在发现结果中显示，并会在调用时默认拒绝。只有设置 PREMIERE_MCP_CAPABILITIES=inspect,edit,export,filesystem,unsafe-script 才能启用它们。

• **除非有特殊原因，否则应通过 stdio 在本地运行。**这是安全的默认选择。
• HTTP 传输（http-server）需要设置 MCP_AUTH_TOKEN，在生产环境中没有设置该变量时会拒绝启动。 它绑定到 0.0.0.0，可从远程访问，因此切勿在没有强令牌和边缘控制的情况下将其公开暴露。 ALLOW_UNAUTHENTICATED=1 仅限非生产环境中的本地或测试用途。
• HTTP 传输仅接受路径严格为 /mcp 的 Streamable HTTP 请求，会限制请求正文、套接字和请求， 并在解析 MCP 请求或开始 Premiere 桥接工作之前，针对每项凭据实施有界的进程内速率和并发限制。 遇到限制措施触发的故障时，会返回 413、429 或 503。还应配置上游速率限制和请求大小限制； 进程本地计数器无法保护多机部署。
• **HTTP 传输不提供网页。**它仅响应 /mcp、/health 和 OAuth 受保护资源元数据请求，并采用拒绝所有内容的内容安全策略。对于 premiere-pro-mcp.fly.dev 或 *.premiere-pro-mcp.com 主机上的其他 GET/HEAD 路径，会重定向（308）到 https://premiere-pro-mcp.com；其他所有主机均会收到 JSON 404。
• 媒体扫描会在异步文件系统操作之间让出执行，并限制遍历总量： 25,000 个条目、5,000 个匹配文件、2,000 个目录、深度 32、1,000 个目录的待处理队列， 以及五秒的协作式时间预算。操作系统调用若发生停滞，实际耗时可能超过该时间预算。 在将监视基线视为完整之前，请检查 scan_incomplete 和 scan_limit_reasons；导入预览也会报告 incomplete。
• 项目备份会以流式方式执行复制和校验和计算，并设有可配置的字节预算。 每个进程同一时间只运行一个备份；并发请求会立即失败。复制失败或取消时，会删除副本，且不会替换现有备份。
• **Docker 运行器使用非特权 node 用户（UID 1000）。**自定义桥接或 上下文卷挂载目录必须允许该用户写入，并仅供操作者使用。 默认上下文目录位于 /home/node/.local/state/premiere-pro-mcp 下。
• CI 会对两个锁定文件运行依赖项审计。请勿将本地 .env*、.npmrc 和 私钥／证书文件提交到版本库或放入 Docker 构建上下文；只有占位用的 .env.example 和 .env.template 文件可以由 Git 跟踪。
• 两个 CEP 面板都会在写入心跳或轮询命令前验证桥接目录。符号链接和归属其他用户的目录会被拒绝。在 POSIX 系统上，服务器和面板都会拒绝对组用户或其他用户可写的目录；仅收紧权限并不能使先前放入的命令变得可信。 在 Windows 上，只有当前用户、SYSTEM 和 Administrators 可以拥有写入权限，包括继承的授权。 Windows 功能和应用容器 SID（S-1-15-*）会被忽略：它们不是登录主体，在标准的 %LOCALAPPDATA% 路径中会显示为继承的 FullControl。 如果 ACL 检查失败，启动也会停止。父级目录同样必须防止其他用户替换桥接路径；在可被广泛写入的父目录中放置私有子目录并不足够（支持 POSIX 粘滞临时目录）。 如果连接器拒绝共享临时文件夹，请在仅归当前用户所有的私有位置下选择新目录，并在服务器和面板上配置相同路径。请勿将被拒绝文件夹中的待处理命令复制到新目录。 Windows 检查会在发布命令前同步调用 PowerShell，超时时间为五秒，输出上限为 64 KiB；这会增加命令延迟，而不是缓存可能过时的权限判定。
• 脚本大小上限为 500 KB，并且有一项简单的正则检查，会拒绝工具生成的脚本中出现 eval()、new Function() 和 System.callSystem()。这只是防护措施， 不是沙箱——它很容易被绕过，并非安全边界。请勿依赖它来限制不可信输入；真正的边界在于谁能访问该服务。

QE DOM

许多工具使用未公开的 QE DOM（通过 app.enableQE() 启用）。这些工具会在说明中标注“使用 QE DOM”。QE DOM 提供了标准 ExtendScript API 不具备的功能：

• 按名称应用效果和转场
• 波纹删除、卷动／滑动／滑移编辑
• 设置剪辑速度和反向播放
• 帧混合和时间插值
• 移除剪辑上的所有效果

常见问题

Adobe Premiere Pro 的 MCP 服务是什么？ 它是一种 Model Context Protocol 服务，可让兼容的 AI 助手在你自己的电脑上，对受支持的 Adobe Premiere Pro 工作流进行结构化且可审查的控制。本项目的显示名称是 MCP for Adobe Premiere Pro；其 npm 包为 premiere-pro-mcp。

如何将它与 Claude 搭配使用？ 安装 Claude Desktop bundle，安装单独签名的 Premiere 连接器，重启 Premiere，然后让 Claude 在不做任何更改的情况下运行 verify_premiere_connection。首次提示词是只读操作。Claude Fable 5.1 是适用于 Cursor、Claude Desktop 或 Claude Code 的可选客户端模型；请参阅 Claude Fable 5.1 工作流。

GitHub 仓库在哪里？ https://github.com/leancoderkavy/premiere-pro-mcp。发布版本、签名的 .zxp 连接器和 Claude .mcpb bundle 均位于该仓库的发布页面。

Premiere Pro 中的桥接面板是什么？ 这是一个本地 CEP 面板（Window > Extensions > MCP for Adobe Premiere Pro），用于将服务连接到正在运行的 Premiere Pro 实例。面板中的“正在运行”表示本地桥接可用；这本身并不能说明编辑已完成。经过身份验证的 UXP 面板是另一种受功能权限控制的连接方式。

有安装指南吗？ 有——premiere-mcp-setup-guide.md 是一份便携指南，你可以将它附加给任何 AI 助手；已发布的文档托管在 https://premiere-pro-mcp.com/docs/。

它能在 Windows 和 macOS 上运行吗？ 两者都支持。需要 Node.js 20.19 或更高版本，以及 Premiere Pro 2020-2026；助手、服务、连接器和 Premiere 应保持在同一台电脑上。各工具的支持情况仍取决于功能权限和宿主环境。

这是 Adobe 的 AI 助手吗？ 不是。这是一个采用 MIT 许可证的独立项目，既不是 Adobe 产品，也不是 Adobe 原生的 AI 助手。它也不同于其他 Premiere Pro MCP 服务；premiere-pro-mcp 是从本仓库发布的唯一 npm 包。

本地优先是否意味着我的 AI 助手不会向云服务发送数据？ 推荐的 Premiere 桥接在本地运行。AI 客户端对提示词和工具结果的处理仍然适用。分享敏感项目信息前，请检查客户端设置；本地优先并不保证绝不会上传数据。

每项操作都会预览、可撤销并经宿主验证吗？ 各工具的约定有所不同。调用编辑操作前，请查看操作模式和审批要求。经回读确认的结果标记为 verified；committed_unverified 表示宿主已接受更改，但验证尚未完成。对于结果不确定的修改，请先检查 Premiere，再尝试重做。评估时请另存一份项目副本，并单独确认渲染输出。

哪些 Adobe Premiere Pro 任务适合作为自动化的起点？ 先进行只读的项目和时间线盘点。然后在项目副本上评估一个范围明确的工作流：经批准的媒体导入、素材箱整理、标记准备或审核帧导出。自动化指南列出了精确的工具约定，并说明需要检查哪些证据。静帧导出不能证明播放或音频正常；本地交付质量检查扫描也不能证明满足了所有平台要求。 搜索引擎和 AI 助手可以在哪里查找最新的产品信息？ 请使用网站的事实页面和 生成的 AI 参考资料，其中介绍了 完整性已验证的已发布 npm 软件包。本 README 中的源码计数 可能包含尚未发布的变更。目录计数和单元测试均无法证明某项操作已在特定的 Premiere 主机上成功执行。

免费吗？ 是的。服务、CEP 连接器和文档均采用 MIT 许可，可免费使用。

故障排除

星标历史

如果这个项目为你节省了 Premiere 中的时间，请点个星标，让其他剪辑师也能找到它。

支持项目

这是一个独立维护的 MIT 许可项目，没有公司支持。 每次发布都会在 Windows 和 macOS 上使用真实的 Premiere 版本进行测试， 这需要硬件、许可证和时间。

免费支持方式，按帮助程度排序：

• ⭐ 为仓库点星 — 编辑发现该项目的主要途径
• 🐛 提交 Bug，注明你的 Premiere 版本、操作系统和出问题的工具名称
• 📝 报告有效情况，说明尚未列入功能覆盖表的宿主版本上哪些功能有效
• 🔧 提交 PR — 参见 CONTRIBUTING.md

赞助资金用于宿主验证、签名证书和托管服务。赞助不会带来优先支持、路线图影响力， 也不代表任何未经验证的宿主行为承诺。

参与贡献

欢迎贡献！请参阅 CONTRIBUTING.md 了解指南。 AI Agent 和 IDE 助手应阅读 AGENTS.md。

这份有证据支持的下一步改进 PR 路线图 将拟议的功能、协议、可靠性和性能工作拆分为十项可供审查的更改， 并为每项更改明确列出依赖项和实时宿主验收门槛。

许可证

MIT — 可免费用于个人和商业用途。