用于 Adobe Premiere Pro 的 MCP 桥接

通过 MCP 操作本地 Adobe Premiere Pro 项目。

284 个工具、13 个上下文资源，以及 10 个引导提示，适用于 Codex、Claude Code、Claude Desktop 和其他 MCP 客户端。CEP 负责编辑；可选的 UXP 辅助程序用于读取 Premiere 语音转文字转录。

语言： English | 日本語 | Tiếng Việt | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | ភាសាខ្មែរ

从这里开始： 安装本地桥接，在 Premiere 中打开它，然后在编辑前运行 verify_premiere_connection。

安装 | Codex 插件 | Claude Code 插件 | 验证 | 隐私政策 | 服务条款 | 安全

安装

受支持的桥接是随附的 CEP 面板。在与 Premiere Pro 和 MCP 客户端相同的计算机上安装 npm 包：

npm install -g @compimprove/adobe-premiere-mcp
premiere-pro-mcp --install-cep
premiere-pro-mcp --doctor

--install-cep 会安装 CEP 桥接、启用所需的 Adobe CEP 调试设置、准备桥接目录，并配置支持的本地 MCP 客户端。--doctor 会验证服务器构建、CEP 安装、桥接目录、调试设置和客户端配置。

然后重新启动 Premiere Pro，打开 Window > Extensions > MCP Bridge (CEP)，设置安装程序显示的桥接目录，然后启动桥接。

要求：

• Node.js 20+

• Adobe Premiere Pro 2020+

• Premiere Pro、MCP 客户端和本包位于同一台计算机上

随附的 uxp-plugin 是一个独立的 Premiere 25.6+ 转录辅助工具。它不能替代 CEP 编辑桥接，且目前尚未通过 CLI 安装。

Codex 插件

从本仓库的克隆中，安装捆绑了 MCP 配置和 Premiere 编辑技能的 Codex 插件：

codex plugin marketplace add .
codex plugin add premiere-pro-mcp@adobe-premiere-pro-mcp

该插件仍然需要本地 CEP 桥接。运行 premiere-pro-mcp --install-cep，重新启动 Premiere，启动 Window > Extensions > MCP Bridge (CEP)，然后让 Codex 依次运行 get_capabilities 和 verify_premiere_connection。

Claude Code 插件

从本仓库的克隆中：

/plugin marketplace add .
/plugin install premiere-pro-mcp@adobe-premiere-pro-mcp

在使用该插件之前，请按照上述相同步骤安装并启动 CEP 桥接。

Claude Desktop 一键捆绑包

每个 GitHub 版本都包含一个适用于 Claude Desktop 的 .mcpb 捆绑包。下载匹配的 adobe-premiere-pro-mcp-<version>.mcpb 资源，并在 Claude Desktop 中打开它以安装本地 MCP 服务器。其首次启动会为当前用户安装捆绑的 CEP 桥接。

重新启动 Premiere Pro，打开 Window > Extensions > MCP Bridge (CEP)，设置桥接目录，然后启动桥接。然后询问 Claude：

运行 verify_premiere_connection。不要做任何更改。

MCPB 捆绑包未签名。请仅从本仓库的 GitHub Releases 中安装它。CEP 发布归档被准确标注为未签名或自签名；自签名并不意味着 Adobe Marketplace 信任。

MCP 客户端配置

安装程序会在 macOS 上配置 Claude Desktop，在 Windows 上配置 Claude Desktop 以及 VS Code 中的 GitHub Copilot。对于其他 MCP 客户端，请将其配置为运行：

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

从源码安装

在开发 MCP、修改 CEP 面板或排查包安装问题时，请使用源码设置：

git clone https://github.com/compimprove/adobe-premiere-mcp.git
cd adobe-premiere-mcp
npm install
npm run build
npm run setup:mac # macOS

在 Windows 上，请在 npm install 和 npm run build 之后，从 PowerShell 运行 npm run setup:win。

Premiere Pro 内部的当前 CEP 面板 UI，使用刷新后的桥接控件和状态布局。

Related MCP server: Premiere Pro MCP Server

当前状态

本仓库目前已验证支持：

• macOS

• 通过 GitHub Actions 进行 Windows 安装程序/配置冒烟检查

• Adobe Premiere Pro 2020+（已在 Premiere Pro 26.0 上积极使用和测试）

• Node.js 20+

• MCP v2 服务器传输，支持现代无状态协议发现

• 随附的 macOS 安装程序路径，适用于 Claude Desktop

• 随附的 Windows 安装程序路径，适用于 VS Code 中的 GitHub Copilot 和 Claude Desktop 配置

• 为 Codex、Claude Code 和类似 MCP 客户端手动注册 MCP

截至 2026 年 8 月 5 日的当前目录状态：

• 暴露了 284 个 MCP 工具，用于 AI 驱动的视频编辑

• 覆盖范围涵盖项目设置、媒体导入、素材箱、序列、时间线编辑、转场、效果、关键帧、字幕、标记、元数据、代理、多机位、颜色、音频、导出以及更高级的组装工作流

• 目录中包含实用的代理工作流，例如产品广告组装、动态图形演示、时间线切割、字幕读取、音频闪避、场景编辑检测、EDL 导入、导出就绪验证以及链接的音频/视频操作

最近完成的本地实时验证：

• 暴露了 284 个活动工具；get_capabilities 报告本地安装和可选的实时连接状态，而 verify_premiere_connection 是规范的只读桥接和主机就绪检查

• 没有广告宣传 0 个已知的停用或占位工具

• import_ae_comps 有意不进行广告宣传，因为 Premiere 在此环境中对真实的 .aep 测试文件返回了 false，并且通用的 .aep 导入可能会卡住 CEP 桥接

完整的实时扫描输出在运行验证器时写入 /tmp/premiere-mcp-bridge/live-tool-sweep.json。

您将获得什么

服务器涵盖项目操作、导入、序列创建、时间线编辑、转场、效果、关键帧、元数据、导出以及更高级的组装工作流。

示例提示：

• "列出所有序列，并告诉我哪个是活动的。"

• "导入这三个镜头，并构建一个粗略的产品广告。"

• "在视频轨道 1 的每个剪切点添加交叉溶解。"

• "对中间的剪辑应用高斯模糊。"

• "对活动的短视频剪辑应用 Black & White 效果。"

• "在 12.5 秒处，跨所有音频和视频轨道切割采访序列。"

• "将活动序列导出为 FCP XML。"

对于单色外观，请优先使用 apply_effect 和 Black & White，而不是尝试通过通用的饱和度调整来强制实现黑白效果。

在编辑之前，您还可以附加 premiere://config/get_instructions 资源，以向模型提供 Premiere 特定的操作指导。

为了确保每次会话都有可预测的开始，请首先运行 verify_premiere_connection。它会确认 CEP 桥接已响应，并返回 Premiere 构建版本、打开的项目和活动序列，而不会修改项目。

包含的高级工作流工具：

• build_motion_graphics_demo

• assemble_product_spot

• build_brand_spot_from_mogrt_and_assets

assemble_product_spot 和 build_brand_spot_from_mogrt_and_assets 现在支持可选的 clipPlan 参数，以便 LLM 可以指导每个剪辑的时间、轨道放置、转场、运动、修剪、效果和颜色调整，而不是依赖固定的模板默认值。

代理技能

如果您希望 Codex、Claude Code 或其他代理能够正确处理安装、验证和日常使用，请安装随附的代理技能：

npx skills add compimprove/adobe-premiere-mcp --skill premiere-pro-mcp

或者直接从技能路径安装：

npx skills add https://github.com/compimprove/adobe-premiere-mcp/tree/main/skills/premiere-pro-mcp

该技能会教代理如何安装 MCP、启动和验证 CEP 桥接、安全地使用 Premiere 工具、在编辑前导入真实媒体、优先使用序列感知操作，以及在出现问题时运行诊断。

高级设置和验证

对于源码安装、特定客户端的 MCP 配置、Windows 安装程序标志、诊断和实时工具扫描，请使用 QUICKSTART.md。它是规范的设置指南，并保持本页专注于选择和使用产品。

简短版本：

1. 使用 npm install -g @compimprove/adobe-premiere-mcp 安装，然后运行 premiere-pro-mcp --install-cep。

2. 重新启动 Premiere Pro 和您的 MCP 客户端，然后启动 Window > Extensions > MCP Bridge (CEP)。

3. 运行 premiere-pro-mcp --doctor，然后要求客户端调用 verify_premiere_connection，而不进行任何更改。

要在任何 MCP 客户端中手动注册，请在 npm 安装后使用全局命令：

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

CEP 仍然是编辑桥接。如果 Premiere 未暴露扩展，请在 Premiere 偏好设置中启用 UXP Plugins > Enable developer mode，重新启动 Premiere，然后重新打开 CEP 面板。单独的 UXP 面板仅用于读取语音转文字转录。

对于真实主机扫描，请使用一次性 Premiere 项目并运行 node scripts/live-tool-sweep.mjs；它会在当前项目中创建临时的 Sweep ... 序列。

对于启用可选转录桥接的源码安装，设置还会：

• 安装依赖项

• 构建 dist/index.js

• 启用 Adobe CEP 调试模式

• 安装 MCP Bridge (CEP) 扩展

• 创建 /tmp/premiere-mcp-bridge

• 准备 UXP 转录命令队列

• 将 premiere-pro MCP 条目添加到 Claude Desktop

重要：

• MCP Bridge (CEP) 仍然是现有编辑工具支持的桥接

• MCP Transcript Bridge (UXP) 是仅由 read_sequence_transcription 使用的可选辅助程序

• 安装程序会自动启用 Adobe CEP 调试模式

• 如果 Premiere 在您的机器上无法干净地暴露扩展，请在打开桥接面板之前，在 Premiere Pro 偏好设置中启用 UXP Plugins > Enable developer mode

• npm run setup:mac 是 macOS 上 Claude Desktop 的最简单路径，因为它会自动更新 Claude Desktop 配置

安装程序完成后：

1. 如果您的 MCP 客户端在启动时读取配置，请退出并重新打开它。如果您使用了安装程序，那意味着 Claude Desktop。

2. 退出并重新打开 Premiere Pro。

3. 在 macOS 上的 Premiere Pro 中，打开 Premiere Pro > Preferences > Plugins 并启用 UXP Plugins > Enable developer mode。

4. 如果更改了设置，请重新启动 Premiere Pro。

5. 打开 Window > Extensions > MCP Bridge (CEP)。

6. 将 Temp Directory 设置为 /tmp/premiere-mcp-bridge。

7. 单击 Save Configuration。

8. 单击 Start Bridge。

9. 要启用转录读取，请在 Adobe UXP Developer Tool 中加载仓库的 uxp-plugin 文件夹，然后打开 Window > UXP Plugins > MCP Transcript Bridge。

10. 在 UXP 面板中，输入 /tmp/premiere-mcp-bridge 作为桥接根目录，单击 Save bridge root，然后单击 Start Bridge。

11. 使用相同的临时目录从 Codex、Claude Code、Claude Desktop 或其他 MCP 客户端连接。

12. 如果 CEP 命令失败，请单击 Run Diagnostics 并发送回 /tmp/premiere-mcp-bridge/premiere-mcp-diagnostics-latest.json。

如果您需要开发模式切换的视觉参考，它看起来像这样：

如果面板在 Start Bridge 后报告 Premiere 已就绪，则桥接已启动。

按客户端安装

Claude Desktop

在 macOS 上，使用：

npm run setup:mac

这是本仓库中唯一自动为您写入 MCP 条目的路径。

Codex

首先构建服务器：

npm install
npm run build

然后在一行中添加 MCP 服务器：

codex mcp add premiere_pro --env PREMIERE_TEMP_DIR=/tmp/premiere-mcp-bridge -- node /absolute/path/to/Adobe_Premiere_Pro_MCP/dist/index.js

Claude Code

以相同的方式构建服务器：

npm install
npm run build

然后使用相同的构建产物 dist/index.js 入口点和相同的临时目录，在 Claude Code 中注册 MCP 服务器：

command: node /absolute/path/to/Adobe_Premiere_Pro_MCP/dist/index.js
env: PREMIERE_TEMP_DIR=/tmp/premiere-mcp-bridge

如果你使用本地 MCP 配置文件而不是辅助命令，请将其指向同一个 dist/index.js 并设置相同的环境变量。

其他 MCP 客户端

使用与 Claude Code 相同的手动注册方式：

command: node /absolute/path/to/Adobe_Premiere_Pro_MCP/dist/index.js
env: PREMIERE_TEMP_DIR=/tmp/premiere-mcp-bridge

以下内容对所有手动客户端设置都很重要：

• 将命令保持在一行内

• 使用 dist/index.js 的真实绝对路径

• 添加或更新 MCP 条目后重启客户端

• 在 Premiere 中启动 CEP 桥接器，并确认临时目录恰好是 /tmp/premiere-mcp-bridge

• 对于 read_sequence_transcription，还需要使用相同的根文件夹启动 UXP Transcript Bridge

验证安装

运行内置检查：

npm run setup:doctor

这会验证：

• Node.js 版本

• 构建后的服务器输出

• CEP 扩展安装

• /tmp/premiere-mcp-bridge

• Adobe CEP 调试模式

• 使用安装程序路径时的 Claude Desktop 配置条目

• 写入 /tmp/premiere-mcp-bridge/premiere-mcp-diagnostics-latest.json 的 CEP 面板诊断信息

• 当可选辅助程序运行时，位于 /tmp/premiere-mcp-bridge/uxp/status.json 的 UXP 转录辅助程序心跳

为了进行更深入的端到端检查，请使用一个可丢弃的 Premiere 项目并运行：

node scripts/live-tool-sweep.mjs

这会在当前打开的项目中创建临时的 Sweep ... 序列，从而让工具链针对真实数据进行演练。

桥接器工作原理

+-----------+        +-----------+        +-----------+
|  Client   |  MCP   | Node.js   | Files  | CEP Panel |
| (Codex+)  |<------>| MCP Server|<------>| edits     |
+-----------+        +-----------+        +-----------+
                                  |
                                  | Files: uxp/commands + uxp/responses
                                  v
                           +-----------+
                           | UXP panel |
                           | transcripts|
                           +-----------+

1. 客户端调用一个 MCP 工具。

2. 现有的编辑工具生成 ExtendScript 并使用 CEP 面板的命令文件。

3. read_sequence_transcription 将带版本号的 UXP 请求写入 uxp/commands。

4. UXP 面板通过 Premiere 的 UXP API 读取源剪辑的语音转文本转录内容，并将规范化响应写入 uxp/responses。

5. 服务器向 MCP 客户端返回结构化 JSON。CEP 和 UXP 不会相互调用。

工具

所有 284 个已宣传的工具都有对应实现。工具模式可通过 MCP 发现获取；本目录用人类语言解释编辑界面。先从 verify_premiere_connection 开始，然后在让代理修改项目之前先检查项目。

发现与项目检查

本目录涵盖：

• 发现与项目检查

• 项目与序列管理

• 媒体导入与素材箱管理

• 时间线放置与剪辑操作

• 效果、转场、颜色与关键帧

• 标记、元数据、标签与工作区域控制

• 导出与交换辅助工具

• MOGRT、字幕、代理与重新链接辅助工具

• 语音转文本转录读取（Premiere 25.6+，需可选 UXP 辅助程序）

• 高级广告/宣传片组装工作流

项目、媒体与素材箱

序列与轨道

时间线编辑与修剪操作

效果、颜色、运动与关键帧

音频、转场和字幕

标记、选择、导航和播放

交付、交换和媒体管理

图形、工作流、工作区和高级操作

其他受支持的操作

其余的工具目录涵盖媒体属性、项目设置、显示格式、抗锯齿、海报帧、颜色标签、选择、轨道目标、项目路径和项目数量的底层控制。包括 set_override_frame_rate、set_override_pixel_aspect_ratio、set_frame_blend、set_time_interpolation、set_poster_frame、set_anti_alias_quality、set_uniform_scale、set_scale_width_height、set_sequence_display_format、set_project_scratch_disk、get_project_scratch_disks、get_all_project_paths、get_total_clip_count、get_insertion_bin、is_work_area_enabled 和 match_frame。

在客户端中使用 MCP 内省，查看每个工具的精确输入模式和返回结构。智能体应先检查，再进行一次有针对性的修改，并在继续多步编辑之前读回受影响的状态。

实际限制

• 自签名的 CEP .zxp 可确认归档完整性，但并不代表 Adobe Marketplace 批准或公共信任保证。可复现的签名工作流需要私有证书机密和目标平台的 Premiere 验证。

此项目比原始原型好用得多，但它并不是魔法。

• Premiere 脚本编写仍无法干净地暴露所有 UI 操作。

• 字幕轨道与 Speech-to-Text 转录不同：read_sequence_captions 仍无法通过 CEP 使用，而 read_sequence_transcription 通过 UXP 读取源剪辑转录。

• 专业标题设计仍依赖真实的 MOGRT 资源或外部图形工作流。

• get_render_queue_status 仅在 Adobe Media Encoder 集成可用时才有用。

• 最佳结果来自真实的源素材、真实的音频和真实的品牌资产。自动化层负责组装和操作它们；它不能替代编辑判断。

故障排查

如果工具可见但调用失败：

1. 确认 Premiere Pro 已打开并加载了项目。

2. 打开 Window > Extensions > MCP Bridge (CEP)。

3. 确认临时目录恰好是 /tmp/premiere-mcp-bridge。

4. 点击 Start Bridge。

5. 如果你更新了桥接代码，右键点击面板并选择 Reload。

6. 重试该命令。

如果 read_sequence_transcription 报告 UXP 桥接不可用：

1. 使用 Premiere Pro 25.6 或更高版本。

2. 启用 Plugins > Enable Developer Mode，然后使用 Adobe UXP Developer Tool 加载 uxp-plugin。

3. 打开 Window > UXP Plugins > MCP Transcript Bridge。

4. 输入 /tmp/premiere-mcp-bridge，点击 Save bridge root，然后点击 Start Bridge。

5. 确保序列中的源剪辑已在 Premiere 的 Text 面板中完成转录。当某些源剪辑没有转录时，该工具会返回部分结果。

如果 MCP 客户端找不到服务器：

1. 验证 dist/index.js 的绝对路径。

2. 验证 PREMIERE_TEMP_DIR=/tmp/premiere-mcp-bridge。

3. 更改配置后重启 MCP 客户端。

4. 运行 npm run setup:doctor。

开发者说明

有用的命令：

npm run build
npm test -- --runInBand
npm run setup:doctor
node scripts/live-tool-sweep.mjs

参见：

• QUICKSTART.md 获取最短安装路径

• KNOWN_ISSUES.md 了解当前限制

• CONTRIBUTING.md 了解开发工作流