Premiere Pro Full MCP v0.2.0

英文 · 韩语

Premiere Pro Full MCP 是一个本地、能力门控的 MCP 服务器，用于 Windows 上的 Adobe Premiere Pro 2026。它结合了有文档记录的 Premiere UXP API、受限的 CEP/ExtendScript 桥接、实验性的 QE 发现机制，以及一个 fail-closed 的本机 Windows UI 代理。

这是一个非官方社区项目，与 Adobe Inc. 无关，也未获得其认可。“Full”是指受支持的 API 面已被盘点并完成路由；它并不表示每个 UI 功能都能在任何宿主状态下被脚本化。

英文

Windows 快速开始

要求：Windows 10/11 x64、Premiere Pro 26.3 或更高版本、Creative Cloud Desktop，以及 Codex Desktop 或 Codex CLI。打包运行时不需要安装 Node.js。

1. 从 最新版本 下载 premiere-pro-full-mcp-v0.2.0-windows.zip。校对其旁的 .sha256 文件，然后解压。

2. 关闭 Premiere Pro，在解压出的 premiere-pro-full-mcp-0.2.0 文件夹中打开 PowerShell，然后运行：

   powershell -NoProfile -ExecutionPolicy Bypass -File .\Install.ps1

   安装程序会验证每个打包文件，只安装到当前用户配置文件，向 Codex 注册 premiere_pro_full_mcp，并打开随附的 CCX。

3. 在 Creative Cloud Desktop 中批准独立插件警告。重启 Premiere，然后打开 窗口 > UXP 插件 > Premiere Pro Full MCP。

4. 首次使用时，单击 Pair with installed helper…，然后选择 %LOCALAPPDATA%\PremiereMCP\app\runtime-bootstrap.json。UXP 只记住该文件的权限；会话令牌不会存储在 CCX 中。

5. 重启 Codex，并调用主机/能力检查工具。如果桥接未连接，请运行 Doctor：

   powershell -NoProfile -ExecutionPolicy Bypass -File "$env:LOCALAPPDATA\PremiereMCP\app\tools\Doctor.ps1" -CheckLive

可执行文件和 PowerShell 脚本没有 Authenticode 签名。Windows 可能会显示 SmartScreen 警告。该版本使用独立的 RSA 签名更新清单、精确的资源大小/SHA-256 绑定，以及包内的 SHA-256 清单。随附的 CEP 兼容桥接带有 Adobe ZXP 包签名，因此安装不会启用 CEP 开发者模式。初始下载仍依赖 GitHub HTTPS 和已发布的校验和；如果校验和或来源意外，不要绕过警告。

更新与卸载

# Download and install the newest authenticated GitHub release
powershell -NoProfile -ExecutionPolicy Bypass -File "$env:LOCALAPPDATA\PremiereMCP\app\tools\Update.ps1"

# Recoverable removal; pairing/workspace data is preserved
powershell -NoProfile -ExecutionPolicy Bypass -File "$env:LOCALAPPDATA\PremiereMCP\app\tools\Uninstall.ps1"

更新会拒绝签名、仓库、标签、名称、大小、摘要、预发布版本和降级不匹配。请分别在 Creative Cloud Desktop > 插件 > 管理插件 中移除 CCX。

安全性与能力约定

• 优先使用有文档记录的 UXP。CEP 填补类型化兼容性缺口，QE 是实验性的，Windows UI Automation 是最后手段。

• 失败的变更绝不会通过另一种后端自动重放。

• 序列导出使用有文档记录的 UXP 编码器路径，但不信任渲染后可能保持失败的宿主状态；成功需要变更后的非空输出文件，并且该文件在多次观察中保持稳定。除非实现了明确批准的覆盖策略，否则现有输出会被拒绝。

• R2 操作使用短生命周期的、绑定范围的、一次性批准 ID，以及独立的受信任 W3D 对话框。等待 — 纠正：R2/R3 操作使用使用短时的、作用域限定的、单次使用的批准 ID，以及独立的受信任 Windows 对话框。

• 原始 ExtendScript、任意 QE/对象路径、原始 UI 选择器/点击、shell 命令和凭据提取不是公开的 MCP 操作。

• 监听器绑定到 localhost，CEP 信封通过 DPAPI CurrentUser 代理进行 HMAC 身份验证，发布产物绝不包含运行时引导材料。

• 文件系统操作仅限于明确批准的规范根目录，并拒绝重解析点逃逸。

• 不收集遥测数据。日志和账本排除提示词、参数、结果、令牌、项目路径、媒体名称和个人标识符。

生成的 X 开头：生成的 Adobe 26.3 清单包含 69 个根对象和 761 个可调用成员。最终的实时全表面基线匹配了所有 761 个 ID。在 312 个确定的只读调用中，281 个成功，31 个因必需的方法、根或会话句柄不可用而失败关闭。另有 151 个有风险条目仅预览，298 个上下文相关条目因明确原因被跳过。请参阅 实时验证。

开发

要求：Node.js 20.19+（推荐 Node 24）、.NET 8 SDK、Premiere Pro 26.3 或更高版本，以及 Adobe UXP Developer Tool。

npm ci
npm run inventory:adobe
npm run check
npm run test:coverage
dotnet test .\windows-ui-agent\tests\PremiereMcp.WindowsUiAgent.Tests.csproj --configuration Release
npm run validate:uxp-plan

发布构建需要干净的 Git 工作树和 %LOCALAPPDATA%\PremiereMCP 下的专用私钥签名密钥。私钥永远不会被提交或上传到 GitHub Actions。请参阅 部署、安全 和 贡献。

한국어

Windows 快速安装

要求：Windows 10/11 x64、Premiere Pro 26.3 或更高版本、Creative Cloud Desktop、Codex Desktop 或 Codex CLI。发布 ZIP 包含自身独立的本机启动器和捆绑的 MCP，因此不需要另行安装 Node.js。

1. 从 最新版本 下载 premiere-pro-full-mcp-v0.2.0-windows.zip 和 .sha256，验证哈希后解压。

2. 关闭 Premiere Pro，在解压后的文件夹中运行以下命令：

   powershell -NoProfile -ExecutionPolicy Bypass -File .\Install.ps1

3. 在 Creative Cloud Desktop 中批准独立插件警告。重启 Premiere，然后打开 窗口 > UXP 插件 > Premiere Pro Full MCP。

4. 首次运行时，点击 **Pair with installed helper…**，然后选择 %LOCALAPPDATA%\PremiereMCP\app\runtime-bootstrap.json。CCX 不存储会话令牌。

5. 重启 Codex。如果未连接，请运行 Doctor：

   powershell -NoProfile -ExecutionPolicy Bypass -File "$env:LOCALAPPDATA\PremiereMCP\app\tools\Doctor.ps1" -CheckLive

安装器会验证包中每个文件的哈希，并验证当前用户配置文件、失败时恢复现有安装和 Codex 配置。稍后安装 CCX 时使用 -SkipCcxLaunch，跳过 Codex 注册则使用 -SkipCodexRegistration。

CEP 兼容桥接通过 Adobe ZXP 方式单独签名，安装器不会启用 CEP 开发者模式。EXE 和 PowerShell 脚本没有 Authenticode 签名，因此应验证已发布的 SHA-256 和 RSA 发布签名。

安全与支持范围

本项目不主张“Premiere 的所有功能在任何情况下都能一定能成功”。它列出了整个公开 API 表面，只将经过实时验证的路径标为受支持，而对于需要项目状态、媒体、插件、登录或权限的路径，则明确指出失败或挂起。UXP、CEP、QE 和 UI 自动化的验证范围分别单独报告。

漏洞请通过存储库的 Security > Report a vulnerability 私下提交，不要通过公开 issue。不要在 issue 或日志中附加令牌、实际项目、用户路径或媒体名称。

支持

如果 Premiere Pro Full MCP 为您节省了时间，您可以在 Ko-fi 上支持持续开发、主机版本测试和安全维护。

MIT License。Copyright (c) 2026 muhwagwa0112。