← 返回目录
A

Adobe Premiere Pro MCP Bridge

社区
通过 MCP 在本地操作 Adobe Premiere Pro 项目
GitHub 源仓库 ↗
★ 578 Stars 分类 · 其他 非常热门
54FMRS · D

这是一个把 Adobe Premiere Pro 本地项目暴露给 MCP 客户端的桥接服务,覆盖从项目检查、素材导入、时间线剪辑、效果与关键帧、音频与字幕,到导出与交付验证的完整链路。它采用渐进式工具发现,默认只公布少量常驻工具以节省上下文。生产路径为 CEP 面板,UXP 仍属实验;服务需要与 Premiere 和 MCP 客户端同机运行,安装涉及 CEP 扩展和客户端配置。使用前应了解删除类工具与任意脚本执行的风险,并注意默认开启的匿名遥测。

可靠性
9/20
安全与权限
8/20
维护活跃度
11/20
文档质量
14/20
安装易用性
12/20
查看 FMRS 评分方法 →

这是一个面向 Adobe Premiere Pro 的本地 MCP 桥接服务。它通过 CEP 面板(生产可用)或实验性的 UXP 面板连接 Premiere,向 Codex、Claude Code、Claude Desktop 等 MCP 客户端暴露 283 个 Premiere 操作工具、13 个上下文资源和 10 个引导提示。默认只对外公布少量常驻工具(search_tools、get_tool_schema、invoke_tool、verify_premiere_connection、list_sequences),其余工具通过 search_tools 检索后用 invoke_tool 调用;设置 PREMIERE_MCP_TOOLSET=full 可让 tools/list 返回完整的 283 个工具。Node 服务把工具调用转换为 ExtendScript 写入 /tmp/premiere-mcp-bridge,CEP 面板轮询该目录并通过 CSInterface.evalScript() 执行,再把结构化 JSON 结果返回给客户端。

工具能力

search_tools
用 BM25 查询或正则模式在 283 个工具的目录中检索工具。
get_tool_schema
获取某个工具的完整输入 schema。
invoke_tool
按名称和参数调用目录中的任意 Premiere 工具。
verify_premiere_connection
只读的桥接与宿主就绪检查,返回 Premiere 版本、打开的项目和活动序列。
list_sequences
列出当前项目中的所有序列。
get_capabilities
报告本地运行能力,以及 catalog.advertised 与 catalog.tools 的差异。
get_project_info
list_project_items
get_active_sequence
list_sequence_tracks
get_sequence_settings
get_full_project_overview
get_full_sequence_info
get_full_clip_info
search_project_items
find_project_item_by_name
find_items_by_media_path
get_timeline_summary
get_timeline_gaps
get_used_media_report
get_offline_media
check_offline_media
get_unused_media
get_duplicate_media
get_clip_properties
get_clip_speed
get_clip_at_position
get_clip_at_playhead
get_premiere_state
get_version_info
ping
create_project
open_project
save_project
save_project_as
close_project
import_media
import_folder
import_image_sequence
import_fcp_xml
import_sequences_from_project
import_sequences
create_bin
rename_bin
delete_bin
create_smart_bin
move_item_to_bin
move_items_to_bin
rename_project_item
rename_clip
delete_project_item
delete_multiple_project_items
create_subclip
refresh_media
relink_media
replace_clip_media
get_metadata
set_metadata
get_xmp_metadata
set_xmp_metadata
get_footage_interpretation
set_footage_interpretation
set_color_label
get_color_label
set_project_panel_metadata
create_sequence
create_sequence_from_preset
create_sequence_from_clips
duplicate_sequence
delete_sequence
close_sequence
set_active_sequence
get_sequence_structure
get_sequence_count
set_sequence_settings
set_sequence_frame_rate
set_sequence_resolution
set_sequence_audio_settings
set_sequence_pixel_aspect_ratio
set_sequence_field_type
add_track
add_tracks
delete_track
rename_track
lock_track
toggle_track_visibility
set_target_track
set_all_tracks_targeted
get_track_info
get_target_tracks
get_sequence_in_out_points
add_to_timeline
add_to_timeline_batch
insert_from_source
overwrite_from_source
overwrite_clip
remove_from_timeline
remove_selected_clips
ripple_delete
move_clip

安装接入

  1. 在安装 Premiere Pro 的同一台电脑上安装 npm 包:npm install -g adobe-premiere-pro-mcp。
  2. 运行 premiere-pro-mcp --install-cep 安装 CEP 桥接、开启所需的 Adobe CEP 调试设置并配置本机 MCP 客户端。
  3. 运行 premiere-pro-mcp --doctor 检查服务构建、CEP 安装、桥接目录、调试设置和客户端配置。
  4. 重启 Premiere Pro,打开 Window > Extensions > MCP Bridge (CEP),填入安装器显示的桥接目录并启动桥接。
  5. 重启 MCP 客户端;如需手动配置,让客户端执行 premiere-pro-mcp 命令。
  6. 先让客户端调用 verify_premiere_connection,确认桥接响应且不做任何修改。

要求:Node.js 20+、Adobe Premiere Pro 2020+,且 Premiere、MCP 客户端与本包在同一台电脑上。

claude_desktop_config.json
{
  "mcpServers": {
    "premiere-pro": {
      "command": "premiere-pro-mcp"
    }
  }
}

选型与风险

适合谁

  • 已经在使用 Premiere Pro 并希望用自然语言驱动剪辑流程的剪辑师
  • 希望批量、可重复地在 Premiere 上执行脚本化操作的用户
  • 使用 Codex、Claude Code、Claude Desktop 等 MCP 客户端的开发者
  • 需要把素材整理、时间线操作和交付检查串成代理工作流的团队

不适合谁

  • 没有本地安装 Premiere Pro 或无法运行 Node.js 20+ 的用户
  • 希望在云端或远程机器上驱动 Premiere 的场景(Premiere、客户端和本包必须同机)
  • 期待全自动专业级成片、替代剪辑判断的用户
  • 需要 Adobe 官方支持或 Marketplace 认证插件的用户(CEP 归档为未签名或自签名)

所需权限

  • 读取和写入 /tmp/premiere-mcp-bridge 桥接目录
  • 写入 ~/.premiere-mcp-bridge/config.json 配置文件
  • 在用户机器上安装 CEP 扩展并开启 Adobe CEP 调试设置
  • 修改本机 MCP 客户端配置(如 Claude Desktop、VS Code 中的 GitHub Copilot)
  • 读取与写入本地 Premiere 项目、媒体文件和导出文件
  • 在启用 detect_silence 时调用本地 ffmpeg
  • 默认发送匿名使用遥测(安装 id、操作系统、包版本、工具名、成功与否)

风险与副作用

  • 工具会真实修改 Premiere 项目,delete_project_item、delete_multiple_project_items、remove_from_timeline 等删除操作不可逆,除非及时使用 undo。
  • execute_extendscript、evaluate_expression 等高级工具可执行任意脚本,必须只在可信输入和明确意图下使用。
  • 自签名或未签名的 CEP 归档只表示压缩包完整性,不代表 Adobe Marketplace 认证或公共信任。
  • MCPB 安装包未签名,只应从该仓库的 GitHub Releases 下载。
  • 默认开启匿名遥测;虽然不上报项目名、媒体路径、参数和结果,但可通过面板设置或 PREMIERE_MCP_TELEMETRY=0 关闭。
  • Premiere 脚本接口并未覆盖全部 UI 操作,部分结果可能被宿主量化或拒绝,需要读回验证。
  • UXP 面板仅为实验性预览,不能替代已验证的 CEP 桥接。

常见排障

  1. 工具可见但调用失败:确认 Premiere 已打开且加载了项目。
  2. 确认已打开 Window > Extensions > MCP Bridge (CEP),并点击 Start Bridge。
  3. 确认桥接临时目录就是 /tmp/premiere-mcp-bridge。
  4. 更新过桥接代码后,右键面板选择 Reload 再重试。
  5. 客户端找不到服务:核对 dist/index.js 的绝对路径和 PREMIERE_TEMP_DIR=/tmp/premiere-mcp-bridge。
  6. 修改配置后重启 MCP 客户端,并运行 npm run setup:doctor 或 premiere-pro-mcp --doctor。
  7. 若 Premiere 未显示扩展,在首选项中启用 UXP Plugins > Enable developer mode,重启 Premiere 后重新打开 CEP 面板。
  8. 首次使用先执行 verify_premiere_connection,它不会修改项目。

使用场景

让 MCP 客户端读取当前项目、媒体库和序列结构,用于剪辑规划
批量导入素材、建仓、创建序列并把片段放到时间线
在时间线上切割、移动、修剪片段,添加交叉溶解等转场
对片段应用效果、关键帧、调色与 LUT
设置片段音量、声像与自动闪避曲线
为序列导出 FCP XML、AAF、OMF 或交给 Media Encoder 渲染
检查离线媒体、重复媒体和未使用媒体
用 assemble_product_spot 等高层工作流组装产品短片或品牌短片

支持客户端

Claude Desktop完整支持
Claude Code完整支持
Codex完整支持
GitHub Copilot in VS Code部分支持
Cursor部分支持