mcpField
P
premiere-pro-mcp

premiere-pro-mcp

github.com/hetpatel-11创意与媒体774866 次安装4 天前更新
代码仓库

关于 premiere-pro-mcp

面向 Adobe Premiere Pro MCP 服务使用者的技能，提供安装、桥接配置和剪辑操作指南。它强调先检查项目状态、使用可用工具，并在修改或导出前确认影响。

主要功能

  1. 01MCP 工具发现与调用指引
  2. 02安装、注册及桥接配置
  3. 03项目、序列和素材检查
  4. 04基于真实导入素材的剪辑流程
  5. 05故障诊断与安全验证

适用场景

  1. 01安装并连接 Premiere Pro MCP 服务
  2. 02检查项目序列和已导入素材
  3. 03规划剪辑、创建序列并验证结果

MCP 相关

此技能用于连接 `hetpatel-11/Adobe_Premiere_Pro_MCP` 的 MCP 服务。它指导通过 `search_tools` 查找工具、用 `invoke_tool` 调用，并配置 Premiere Pro 的 CEP 桥接。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/hetpatel-11/adobe_premiere_pro_mcp --skill premiere-pro-mcp

安装后在 Claude Code 中输入/premiere-pro-mcp确认已加载。

详细介绍

Adobe Premiere Pro MCP

使用 hetpatel-11/Adobe_Premiere_Pro_MCP 中的 Adobe Premiere Pro MCP 服务时，请使用此技能。

核心规则

  • 使用 MCP 工具执行 Premiere 操作；除非 MCP 工具集缺少所需操作，否则不要自行编写 ExtendScript。
  • 默认的 MCP tools/list 只包含一小部分始终启用的工具。调用 search_tools（使用 BM25 查询或正则表达式模式），然后使用准确的名称调用 invoke_tool。PREMIERE_MCP_TOOLSET=full 会列出所有工具。
  • 优先先进行只读探索：get_project_info、list_sequences、list_project_items、get_active_sequence，以及相关资源读取操作。
  • 使用实际导入的媒体。如果用户要求使用素材进行编辑，请确认文件路径存在，使用 import_media 导入，然后将导入的项目项 ID 放入序列中。
  • MCP 服务和 CEP 面板应使用一致的临时目录：/tmp/premiere-mcp-bridge，除非用户明确配置了其他路径。
  • 执行破坏性操作或会对外产生影响的操作前，请先征求用户同意：删除片段或媒体、覆盖导出文件、关闭项目、将重要项目文件另存为，以及向其他位置发送文件。
  • 对于生成或演示性质的编辑，优先创建名称清晰的新序列，而不是修改用户当前使用的序列。
  • 如果工具返回 success: false，请报告准确的错误，并在盲目重试前运行诊断。

安装流程

如果用户要求安装或配置 MCP：

  1. 检查操作系统。自动安装程序主要针对 macOS。
  2. 克隆或打开仓库：
git clone https://github.com/hetpatel-11/Adobe_Premiere_Pro_MCP.git
cd Adobe_Premiere_Pro_MCP
  1. 在 macOS 上运行：
npm run setup:mac
  1. 在非 macOS 系统上，或手动配置客户端时，运行：
npm install
npm run build
  1. 使用以下内容在用户的客户端中注册 MCP 服务：
command: node /absolute/path/to/Adobe_Premiere_Pro_MCP/dist/index.js
env: PREMIERE_TEMP_DIR=/tmp/premiere-mcp-bridge

对于 Codex，优先使用：

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

启动 Premiere Bridge

安装后：

  1. 如果 MCP 客户端只在启动时读取配置，请重启客户端。
  2. 重启 Premiere Pro。
  3. 打开 Window > Extensions > MCP Bridge (CEP)。
  4. 将 Temp Directory 设置为 /tmp/premiere-mcp-bridge。
  5. 点击 Save Configuration。
  6. 点击 Start Bridge。
  7. 确认 Bridge 面板显示 Premiere 已就绪，然后再运行编辑工具。

如果 Premiere 未运行，你仍然可以安装、构建和注册 MCP，但请告知用户，实时工具验证需要 Premiere 和 CEP Bridge 面板。

验证

运行本地检查：

npm run setup:doctor

如果 Premiere 正在运行且 Bridge 已启动，请使用安全的只读调用进行验证：

  • get_project_info
  • list_sequences
  • list_project_items

如需在一次性项目中进行更深入的验证，请使用 create_sequence_from_clips 创建测试序列，或通过 create_sequence 和真实的 .sqpreset 路径创建测试序列，然后调用 list_sequences 并确认序列存在。不要在没有预设的情况下创建空白序列，因为较新版本的 Premiere 可能会打开阻塞 CEP 的原生对话框。

编辑策略

  • 先了解项目：项目信息、当前使用的序列、现有媒体、轨道、标记，以及选中的序列。
  • 在进行任何更改前，制定具体的 Premiere 操作计划。
  • 对于粗剪，先导入媒体，然后使用 create_sequence_from_clips，让 Premiere 在不弹出原生对话框的情况下推导设置。只有在使用真实的 .sqpreset 时才使用 create_sequence；如果现有序列已定义所需设置，则使用 duplicate_sequence 并设置 clearContents=true。
  • 对于产品或品牌广告片，如果用户的需求符合相应工作流，优先使用 assemble_product_spot 或 build_brand_spot_from_mogrt_and_assets。
  • 对于黑白效果，请使用 apply_effect 并设置 Black & White，而不是仅通过通用饱和度调整来实现。
  • 对于时间线剪辑，优先使用针对序列的工具，并在可用时包含 sequenceId。
  • 仅在确认输出路径、格式或预设，以及覆盖行为后才进行导出。

故障排除

如果命令超时或报告桥接错误：

  1. 确认 Premiere 已打开。
  2. 确认 Window > Extensions > MCP Bridge (CEP) 已打开，且桥接已启动。
  3. 确认两端使用相同的临时目录。
  4. 运行：
npm run setup:doctor
  1. 请用户点击 CEP 面板中的 Run Diagnostics。
  2. 如果 /tmp/premiere-mcp-bridge/premiere-mcp-diagnostics-latest.json 存在，请读取该文件。
  3. 仅当旧命令/响应文件明显过期，且桥接已停止或处于空闲状态时，才将其删除。

常见修复方法：

  • 临时目录出现 ENOENT：创建 /tmp/premiere-mcp-bridge，再次保存配置，然后重启桥接。
  • 工具在 Premiere 中执行成功，但报告失败：运行 list_sequences 或相关列表工具，以确认状态后再重试。
  • 临时目录配置为空或格式不正确：字段中只填写路径，不要填写 JSON 或环境变量赋值。

评论

支持 Markdown