leancoderkavy/premiere-pro-mcp · 上手攻略

• 仓库：leancoderkavy/premiere-pro-mcp
• 链接：https://github.com/leancoderkavy/premiere-pro-mcp
• 分类：AI 工程 / 创意工具
• 作者：Jay
• 更新：2026-10-02

这是什么

premiere-pro-mcp 是一个基于 MCP（Model Context Protocol） 的本地优先服务器，让 AI 助手（Claude、Codex、Cursor 等）通过 Adobe Premiere Pro 原生 CEP/ExtendScript 接口直接控制 Premiere Pro。它不是 Premiere 的 AI 生成功能，而是给 AI 编辑助手提供的工具层——导入素材、整理时间线、应用转场与调色、导出等操作都能通过自然语言完成。

⚠️ 本项目与 Adobe 无关联，独立开发，MIT 许可。

解决什么问题

视频后期剪辑中，重复性操作（整理素材、整理时间线、批量导出检查）耗时巨大。传统方案靠脚本或插件，且通常绑定特定 AI 提供商。premiere-pro-mcp 的核心价值：

• AI 助手直连：Claude / Codex / Cursor 等 MCP 兼容客户端，无需手动操作界面，直接对话指挥 Premiere
• 本地优先：npm 全局安装，数据不离开本机，无云端依赖
• 工具可审计：386 个核心工具（v1.18.6 正式包 384 个），覆盖导入、转场、特效、关键帧、导出等完整链路
• 双轨兼容：CEP/ExtendScript（传统，Pro 2020-2026 支持）+ UXP（新路线，能力门控额外 96 个工具）

快速安装

依赖条件

• Node.js 环境（用于 npm 安装）
• Adobe Premiere Pro 2020-2026（Windows 或 macOS）
• ZXP 安装器（用于安装 Premiere 端连接器）

安装步骤

方式一：npm 全局安装（推荐）

npm install -g premiere-pro-mcp@1.18.6

方式二：验证包名（防重名陷阱）

⚠️ 存在另一个包 adobe-premiere-pro-mcp 也声明同名可执行文件，配置前必须核对：

npm list -g premiere-pro-mcp
premiere-pro-mcp --version
npm view premiere-pro-mcp homepage   # 应返回 https://premiere-pro-mcp.com/
npm view premiere-pro-mcp repository.url  # 应返回 GitHub 仓库地址

安装 CEP 连接器（必须）

premiere-pro-mcp --install-cep

重启 Premiere Pro，然后在 Window > Extensions > MCP for Adobe Premiere Pro 打开面板。

Claude Desktop 快速配置（无需 Node.js 运行 MCP）

1. 下载 Claude Desktop 捆绑包 .mcpb
2. Claude Desktop → Settings → Extensions → Advanced → Install Extension → 选下载的 .mcpb → 重启
3. 下载 签名连接器 .zxp，用 ZXP 安装器打开
4. 重启 Premiere，打开测试项目，Extensions 面板确认 Running
5. Claude 中发送：Safely check my Premiere connection with verify_premiere_connection. Make no changes.

远程部署（Fly.io）

README 提供了远程 MCP 服务的 Docker 部署路径，unauthenticated caller 会被拒绝，不绑定本地 Premiere 进程。详见 Remote Deployment (Fly.io) 段落。

核心用法

验证连接

# 连接诊断（仅读取，不修改项目）
premiere-pro-mcp --doctor
# 输出服务器安装状态、配置状态、连接状态、实时验证结果

# 生成修复计划（隐私安全，不写文件）
premiere-pro-mcp --doctor --plan-fixes

MCP 协议切换（遇到兼容性问题时）

默认使用 2026-07-28 标准协议（HTTP / stdio 双传输）。若客户端与服务发现握手失败，设置：

export PREMIERE_MCP_PROTOCOL_MODE=legacy
# 然后重启客户端

⚠️ legacy 模式只使用基础 stdio 传输和旧版握手，缺失现代 MCP 能力（discovery、cache hints、subscription stream 等）。

典型 AI 对话示例

在 Claude / Codex 中输入类似指令：

"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."

工具链会：识别 V2 轨道 → 逐段插入 B-roll → 应用 cross dissolve → 逐 clip 匹配 A-roll 色调 → 配置 ProRes 1080p 导出任务。

MCP 资源与工具

工具分类（全部约 386 个，UXP 连接后 478 个）：

• Editorial planning：字幕/SRT 解析、素材整理、模板规划
• Import / source：素材导入、元数据读取、bin 管理
• Timeline editing：轨道操作、插入/覆盖编辑（QE sync-locked 轨道 ripple 而非 desync）
• Effects / keyframes：转场、特效、关键帧应用
• Color correction：色彩校正（自动匹配 A-roll）
• Export：多格式导出配置、渲染队列
• MOGRT Studio（可选 After Effects 连接器）：标题/字幕模板创作、批量发布、AE→Premiere 转交
• Review handoff：项目交接、review frame 导出

⚠️ 状态说明：工具返回 committed-but-unverified 表示已执行但未二次验证，用户需人工确认。

环境变量

典型适用场景

1. 批量重复剪辑：多段相同结构视频（教程、评测、产品展示），用 AI 批量套用模板和转场
2. 素材整理自动化：根据 AI 分析自动归类素材到不同 bin，减少人工整理时间
3. 跨语言字幕流程：SRT/VTT 解析 + 字幕轨道自动创建 + 时间轴匹配
4. AI 辅助粗剪：AI 读取脚本和素材，生成粗剪建议时间线，人类审核后执行
5. MOGRT 模板工厂：After Effects 模板批量创建 → Premiere 直接使用，适合品牌内容生产
6. 多 AI 协作：Codex 负责代码/工程任务，Claude 负责创意决策，共享同一 Premiere 连接

坑与注意

⚠️ 包名混淆陷阱：另一个包 adobe-premiere-pro-mcp 也声明 premiere-pro-mcp 可执行文件，安装前必须核对包名和仓库 URL。

⚠️ 第一次改动必须谨慎：官方推荐先用 disposable（复制出来的测试项目）练手，确认工具行为后再操作真实项目。

⚠️ UXP vs CEP 能力差异：CEP 是主路线（2020-2026 全部支持），UXP 是独立面板，提供额外 96 个工具但不替代 CEP。两者可以共存。

⚠️ 数据库/项目文件：MCP 工具可以读写 Premiere 项目文件（.prproj），但无版本控制，操作前强烈建议 git 管理或手动备份。

⚠️ 导出格式选择：ProRes 导出需要对应 codec 许可；H.264/H.265 导出依赖 Premiere 编码器配置，AI 配置错误可能导致渲染失败。

⚠️ MOGRT 连接器独立安装：After Effects MOGRT 创作功能需要单独安装 AE CEP 连接器，不是默认安装项。

⚠️ 协议兼容性边界：若 MCP 客户端不能完成 server/discover probe，必须设置 PREMIERE_MCP_PROTOCOL_MODE=legacy，参考 文档。

与同类对比

premiere-pro-mcp 的差异化在于 MCP 协议层——不绑定任何单一 AI 提供商，一个工具链同时支持 Claude、Codex、Cursor、Windsurf 等所有 MCP 客户端，且安装简单（npm + ZXP）。

一句话推荐结论

本地 Premiere Pro 的 AI 控制层，让剪辑工作流接入任意 MCP 兼容 AI 助手，工具覆盖完整，适合视频工作室和 AI 工作流开发者快速原型化 AI 辅助剪辑流程。

⚠️ 存疑项：UXP 连接器的稳定性和大规模项目（多轨道、复杂特效）下的工具可靠性尚未有大样本验证，实际生产环境建议从小项目开始逐步扩大范围。