Premiere-MCP-IMT + SKILLS — Premiere Pro for AI agents

Premiere-MCP-IMT + SKILLS — 面向 AI Agent 的 Premiere Pro

让 AI 助手（Claude Desktop、Cursor、ChatGPT、Google Antigravity 或任何 MCP 客户端）在正在运行的 Adobe Premiere Pro 中工作：读取项目及其序列，剪切、修剪、移动和波纹编辑片段，应用效果、转场和关键帧，添加标记和字幕，重新构图，检查帧并导出——只需使用自然语言。

支持所有 Adobe UI 语言 · 丰富的技能库 · 专为生成式功能打造。 Premiere-MCP-IMT 支持 Adobe 提供的所有 UI 语言，附带丰富的技能库，并专为 Adobe 的生成式功能打造——生成式扩展、生成式媒体、对象蒙版、增强语音、转录和字幕、自动重新构图、搜索、AI 助手。

两部分协同工作：

• MCP 服务 — 通过九个工具提供约 440 项 Premiere 操作；写入操作会通过回读 Premiere 进行验证；支持所有 Premiere UI 语言（已实机验证）；不收集遥测数据。
• 技能（skills/pr，也可通过 pr_skill 工具调用，因此适用于任何客户端）— 介绍如何安全地操控 Premiere、脚本功能的边界，以及如何使用 Premiere 自带的 AI 工具：生成式扩展、生成式媒体工具（视频、音效、音乐）、对象蒙版、语音转文本和纸上剪辑、字幕、增强语音和分离音轨、搜索、AI 助手、自动重新构图、场景编辑检测、形态剪辑——还包括组合使用这些工具的操作指南及注意事项。

专为本地化版本的 Premiere 打造，而不只是英文版。 大多数 Premiere MCP 服务和 Agent 技能都假设 UI 为英文——在德语、中文或俄语版本中，效果、转场和参数名称就会对不上。Premiere-MCP-IMT 通过 matchName 查找组件，并利用 Premiere 自带的 UI 字典翻译英文效果、转场和参数名称，因此同一 Agent 和同一技能可在 Premiere 提供的全部十种 UI 语言中使用——已实机验证。

由 Immersive Media Technologies 开发。

macOS 和 Windows · Premiere Pro 2024–2026 — 已在 macOS（26.5）和 Windows 11 ARM（26.5.2，Microsoft Store 版 Claude Desktop）上实机验证 · Node.js 20.19+（使用 Claude Desktop 扩展时无需安装）。

注意

这会编辑真实的 Premiere 项目，而脚本撤销功能只能还原部分编辑——请在副本上操作。项目内容（名称、转录文本、标记、帧）会发送到你使用的 AI 服务。Premiere 的生成式工具会消耗你的 Adobe 点数；Agent 会在启动前征求确认。原始 ExtendScript 默认关闭，除非你手动开启。

你可以这样提出请求

• “列出活动序列中所有短于 12 帧的片段和所有间隙。”
• “把这段访谈中的停顿缩短到三分之一秒，并在摄像机固定时出现的跳切处添加形态剪辑。” (技能)
• “为这个剪辑制作 9:16 和 1:1 版本，并检查标题是否避开 TikTok UI 区域。”
• “把整个镜头中左侧男人的脸模糊处理。” (技能：你点击对象蒙版中的主体，Agent 会处理其余工作)
• “这段访谈的音乐是在现场录制的——去掉它，再在对白下方重新配乐。” (技能)
• “标记这首曲子的每个节拍，并按每个镜头两拍的节奏排列精选片段。”

Agent 会自行组合这些操作，并在步骤之间检查序列；技能会告诉它哪种 Premiere AI 工具适合当前任务、使用成本以及可能出现的问题。

安装

你需要在此电脑上运行 Premiere Pro，并安装连接器——这是 Premiere 内部的一个小型 CEP 扩展，服务会与它通信。Agent 首次使用时会为你安装（pr_install_connector，会先征求你的同意；然后退出并重新打开 Premiere），也可以使用下方的安装程序安装。

客户端	方法
Claude Desktop	下载 premiere-mcp-imt.mcpb，双击，然后点击 Install（Windows：将文件拖到 Settings → Extensions）。无需 Node。
Cursor	添加到 Cursor — 一键完成：Cursor 会打开并写入配置（或者将下方代码片段放入 ~/.cursor/mcp.json）。
Google Antigravity	Settings → Customizations → Installed MCP Servers → View raw config → 添加下方代码片段。
ChatGPT（仅限远程服务）	在运行 Premiere 的电脑上执行：npx -p @immersive-media-technologies/premiere-mcp-imt premiere-mcp-imt-chatgpt — 它会通过隧道启动服务，并打印可粘贴到 ChatGPT 的 URL。
任何 MCP 客户端	将下方代码片段放入其 mcpServers。

{
  "mcpServers": {
    "premiere": {
      "command": "npx",
      "args": ["-y", "@immersive-media-technologies/premiere-mcp-imt"]
    }
  }
}

从源码安装，并进行实时自检（我们使用的方式）：

git clone https://github.com/Immersive-Media-Technologies/premiere-mcp-imt.git
cd premiere-mcp-imt && ./install.sh        # Windows: .\install.ps1

安装程序会检查 Premiere、Node 和 FFmpeg，进行构建、安装连接器（会先征求你的同意），询问正在运行的 Premiere 连接器是否有响应，并在征得同意后将条目写入 Claude Desktop、Cursor 和 Antigravity 的配置，同时备份原配置。

如果无法连接

• pr_verify 显示连接器没有响应：连接器安装完成后，完全退出 Premiere 并重新打开；关闭所有已打开的 Premiere 对话框（模态对话框会阻止脚本运行）。premiere-mcp-imt --diagnose-cep 会检查文件、调试标志和 Premiere 的签名日志。
• 连接器未签名：CEP 必须允许未签名扩展（CSXS 9–14 将 PlayerDebugMode 设为 1；在 Windows 上，这是 HKCU\Software\Adobe\CSXS.<n> 下的 String (REG_SZ) 值）。安装程序会设置此值。
• macOS 上出现 spawn npx ENOENT：图形界面应用无法读取 shell 的 PATH — 将 npx 替换为 Homebrew 或 nodejs.org 中 Node 的绝对路径（它们无法访问 nvm 的 Node）。
• 响度、静音（detect_silence）、节拍和场景切换分析需要 FFmpeg（brew install ffmpeg、winget install Gyan.FFmpeg）。
• Windows 上从 Microsoft Store 安装的 Claude Desktop：Store 应用对注册表写入进行了沙盒隔离。如果在运行 pr_install_connector 后 Premiere 没有加载连接器，请在源码检出目录中打开普通 PowerShell，运行一次 powershell -ExecutionPolicy Bypass -File scripts\install-cep.ps1（或使用 install.ps1）。
• premiere-mcp-imt --doctor 会检查本地安装，不会读取项目。

安全保障

经过验证的写入	编辑后会从 Premiere 读回并报告 verified，但仅当读回内容匹配时才会如此；其他情况均报告为未确认。如果编辑结果未知，则会暂停后续编辑，直到 Agent 检查项目并确认——重试绝不会重复应用更改。
Premiere 会记录的操作可撤销，其他操作使用检查点	Premiere 会在历史记录中记录的编辑（添加或移除效果、剪切、插入）会报告 undoSteps，并可通过 undo 撤销——每个步骤都会根据 Premiere 的撤销堆栈进行检查（实验性 QE）。属性和标记的写入不会被记录：在进行风险较高的编辑前，create_sequence_checkpoint 会克隆序列；diff_sequence_snapshots 会准确显示更改内容（片段的添加、移除、移动、修剪以及帧数差异）。
规划 → 预览 → 应用	plan_* 操作只进行计算；复合编辑只有在使用其预览生成的确认令牌且令牌未改变时才会应用。
只读模式	PR_MCP_READONLY=true — 仅可检查和导出；项目无法更改。
默认不启用原始脚本	只有设置 PR_MCP_ENABLE_SCRIPT=true 时才会启用 pr_execute_script。
无遥测	服务端不会向任何地方发送数据。

工具

工具	用途
pr_verify	连接器、已打开的项目和活动序列——首次调用
pr_get_sequence	轨道和片段及其 node_id、时间和速度
pr_catalog / pr_do / pr_batch	探索约 440 项操作（44 个类别）并运行一项或多项
pr_export_frame	将序列中的一帧导出为 PNG — Agent 的眼睛
pr_save_project	保存
pr_install_connector	检查／安装 Premiere 中的连接器
pr_skill	Agent 技能：路由器及其参考资料
pr_execute_script	原始 ExtendScript — 仅在启用时可用

PR_MCP_FACADE=0 会将每项操作分别列为一个工具（定义超过 600K 个令牌，超出大多数上下文窗口的容量；九个工具约占 1.5K 个令牌）。

变量	默认值	含义
PR_MCP_READONLY	关闭	true → 仅可检查和导出
PR_MCP_ENABLE_SCRIPT	关闭	true → 启用 pr_execute_script（任意 ExtendScript）
PR_MCP_FACADE	开启	0 → 将每项操作列为单独的工具
PREMIERE_MCP_CAPABILITIES	—	显式配置，例如 inspect,edit,export,filesystem；优先于各开关
PREMIERE_TEMP_DIR	OS 临时目录	连接器的文件邮箱
PREMIERE_UXP_TOKEN	—	启用可选的 UXP 桥接（需在 Premiere 中安装 UXP 插件）及其 *_uxp 操作

技能

skills/pr/SKILL.md 是一个简短的路由器，Agent 会先读取它（不带参数的 pr_skill）；它会指向任务所需的一份参考文档（pr_skill {doc}）：

SKILL.md	工具、工作顺序（状态 → 检查点 → 操作 → 先按值验证，再按帧验证）、寻址方式（节点 ID、源时间与序列时间、由所选内容驱动的操作、本地化的 Premiere），以及一张说明脚本在 Premiere 中无法执行哪些操作并附有对应参考文档的表格。
references/generative.md	生成式扩展、生成式媒体工具（使用首帧／末帧／参考帧生成视频、使用语音参考生成音效、音景、音乐）、Firefly Boards → 序列、合作伙伴模型、每秒积分数。
references/masking.md	对象蒙版、新蒙版为何“毫无作用”、剪辑关键帧与帧关键帧、锐化／扩展、蒙版数据的存储位置及其丢失原因。
references/speech-text.md	语音转文本、基于文本编辑停顿和填充词、纸上剪辑、单词字幕，以及服务端的词级时间轴规划器（填充词、停顿、重录、哔声、字幕）。
references/audio.md	增强语音、人声分离（测试版）、通过 UI 和关键帧进行闪避、混音、FFmpeg 分析。
references/timeline-automation.md	自动重构图、场景编辑检测、变形剪辑（以及为何导出时会变成叠化）、颜色匹配、变形稳定器。
references/search-assistant.md	搜索面板（媒体智能、相似帧、声音搜索），以及与 Agent 并列的 AI 助手测试版。
references/combos.md	11 种组合使用工具的方案：在两个剪辑之间生成镜头、清理访谈、跟踪模糊人脸、从故事板生成序列、移除现场音乐、制作社交媒体版本、按静音和节拍剪辑。
references/gotchas.md	按地区和许可证划分的可用性、积分、测试版与正式版、交接给调色和混音、导出，以及看似故障的脚本限制。

支持自有技能的客户端可以直接加载此文件夹（例如，将 skills/pr 复制到 ~/.claude/skills/）。

为什么选择这个

目前有多个 Premiere MCP 服务；它们在模型能看到什么、了解什么以及会将什么发送回家方面各不相同。截至 2026-10-26：

	Premiere-MCP-IMT	premiere-pro-mcp（上游）	AdobePremiereProMCP	Adobe_Premiere_Pro_MCP	flue
模型默认可见的工具	9 个，约 440 种操作	完整目录（约 440 个工具）	约 1,060 个工具中的 74 个（配置文件 standard）	5 个，涵盖 283 种以上的操作	无——Agent 通过管道传递 ExtendScript
对 Premiere AI 工具的了解	技能文档，含 8 份参考资料和方案	2 项技能（剪辑、开发）	7 项工作流技能	1 项技能	1 项技能（脚本编写）
非英语版 Premiere	所有 UI 语言（共 10 种），均经过实时验证	测试过英语和 es-ES	未说明	未说明	未说明
遥测	无	PostHog，除非设置密钥，否则关闭	未发现	默认开启（可选择退出）	未提及
连接器安装	由 Agent 在征得同意后安装；安装程序带有实时自检功能	CLI 标志	从源代码构建（Go、Rust、Python）	CLI 标志	pip + 设置
客户端	Claude Desktop（.mcpb）、Cursor、Antigravity、ChatGPT 网关、任意 MCP 客户端	npm、.mcpb、Codex / Claude Code 插件	从源代码构建	npm、插件、.mcpb	CLI + 技能
许可证	Apache-2.0	MIT	MIT	MIT	MIT

除了技能和打包方式之外，我们对上游代码做出的更改包括：通过 matchName 查找组件和属性，并使用 Premiere 自带的 UI 词典将英文名称转换为本地化名称（在本地化的 Premiere 中，上游的所有不透明度、运动、关键帧和音量操作都会失败）；添加 split_clip，以剪切指定的剪辑（上游剪切的是轨道 0）；不收集遥测；仅使用 stdio；以及精简工具集。

发布版本

每个版本的说明见 发布版本 页面；所有 变更都记录在 CHANGELOG.md 中。

• v1.1.1 · 2026-10-28 — Premiere 主屏幕：未打开项目时，pr_verify 会明确说明；未打开项目时尝试进行的编辑也不再 阻止后续编辑。
• v1.1.0 · 2026-10-28 — 基于 premiere-pro-mcp 1.26.0 构建：每项编辑都会从 Premiere 读回验证，新增约 60 项操作，并将 UI 语言 层迁移到新代码中；使用 pr_install_connector 重新安装连接器。
• v1.0.2 · 2026-10-28 — 全面提供说明：支持所有 Adobe UI 语言，拥有丰富的技能库，并为 Adobe 的生成式功能打造。
• v1.0.1 · 2026-10-28 — 产品名称改为 Premiere-MCP-IMT（原名 PR-MCP-IMT）；MCP Registry 条目也列出了 npm 软件包；该软件包自 1.0.0 起已发布到 npm。
• v1.0.0 · 2026-10-28 — 支持所有 Premiere UI 语言（英文名称通过 Premiere 自带的词典翻译；已进行 实时验证），对未知效果给出准确结果，支持色彩校正和 LUT，采用 Apache-2.0 许可证。
• v0.1.0 · 2026-10-26 — 首次公开发布：Premiere Agent 技能、九工具接口、pr_skill、由 Agent 安装连接器、Claude Desktop 扩展、带实时自检的安装程序，以及 ChatGPT 网关。

npm test 可离线运行——无需 Premiere。

许可证

Apache License 2.0 — © Immersive Media Technologies。

• 可免费使用、修改和分发，包括商业用途。
• 必须注明出处。 每次重新分发本软件或其衍生作品时， 都必须附上 NOTICE 中的声明： Premiere-MCP-IMT by Immersive Media Technologies — https://github.com/Immersive-Media-Technologies。
• 不提供任何担保。

第三方声明（上游 MIT 代码）：THIRD-PARTY-NOTICES.md。Adobe、Premiere Pro 和 Firefly 是 Adobe Inc. 的商标；本项目与 Adobe 无关联，也未获 Adobe 背书。