Premiere Pro MCP

注： 这是一个bug修复PR的临时分支。请参阅原始版本 leancoderkavy/首映亲mcp.

Premiere Pro MCP服务器

让AI完全控制Adobe Premiere Pro。

28个模块中的269个工具——用于视频编辑的最全面的MCP服务器。

 ](https://nodejs.org)  ](https://www.npmjs.com/package/premiere-pro-mcp)  

______________________________________________________________________

这是什么？

一 MCP（模型上下文协议） 让AI助手喜欢的服务器 克劳德, 帆板运动, 光标，或任何与MCP兼容的客户端直接控制Adobe Premiere Pro——导入媒体、编辑时间线、应用效果、管理关键帧、导出等。

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

人工智能通过269个工具处理整个工作流程，这些工具几乎涵盖了Premiere Pro中提供的所有ExtendeScript和QE DOM API。

______________________________________________________________________

快速开始

1.安装

选项A-npm（推荐）：

npm install -g premiere-pro-mcp

选项B--从源克隆：

git clone https://github.com/ppmcp/premiere-pro-mcp.git
cd premiere-pro-mcp
npm install
npm run build

2.安装CEP插件

如果通过npm安装：

premiere-pro-mcp --install-cep

如果从源克隆：

npm run install-cep

此符号将插件链接到Premiere Pro的扩展文件夹中，并启用调试模式。

Manual installation (macOS)

mkdir -p ~/Library/Application\ Support/Adobe/CEP/extensions
ln -s "$(pwd)/cep-plugin" ~/Library/Application\ Support/Adobe/CEP/extensions/MCPBridgeCEP

# Enable unsigned extensions (CSXS 9–14)
for v in 9 10 11 12 13 14; do
  defaults write com.adobe.CSXS.$v PlayerDebugMode 1
done

Manual installation (Windows)

1. 复制 cep-plugin 文件夹到 %APPDATA%\Adobe\CEP\extensions\MCPBridgeCEP
2. 打开注册表编辑器并将这些DWORD值设置为 1:

- HKEY_CURRENT_USER\Software\Adobe\CSXS.12\PlayerDebugMode - （对CSXS.9至CSXS.14重复此操作）

3.配置您的MCP客户端

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：

{
  "mcpServers": {
    "premiere-pro": {
      "command": "node",
      "args": ["/absolute/path/to/premiere-pro-mcp/dist/index.js"],
      "env": {
        "PREMIERE_TEMP_DIR": "/tmp/premiere-mcp-bridge"
      }
    }
  }
}

Windsurf / Cascade

添加到MCP服务器配置中：

{
  "premiere-pro": {
    "command": "node",
    "args": ["/absolute/path/to/premiere-pro-mcp/dist/index.js"],
    "env": {
      "PREMIERE_TEMP_DIR": "/tmp/premiere-mcp-bridge"
    }
  }
}

Cursor

添加 .cursor/mcp.json 在您的项目或全局配置中：

{
  "mcpServers": {
    "premiere-pro": {
      "command": "node",
      "args": ["/absolute/path/to/premiere-pro-mcp/dist/index.js"],
      "env": {
        "PREMIERE_TEMP_DIR": "/tmp/premiere-mcp-bridge"
      }
    }
  }
}

4.在Premiere Pro中启动桥接

1. 打开（或重新启动）Premiere Pro
2. 首选 窗口>扩展>MCP桥
3. 设置 临时目录 以匹配您的MCP客户端配置（例如。， /tmp/premiere-mcp-bridge)
4. 点击 开始桥 --您应该看到绿色的“正在运行”状态
5. 问你的AI助手： *“我目前的Premiere Pro项目是什么？”*

______________________________________________________________________

建筑

本地（stdio）：

┌───────────────┐   stdio (MCP)   ┌──────────────┐   File-based IPC   ┌──────────────┐
│  AI Client    │ ◄──────────────► │  MCP Server  │ ◄────────────────► │  CEP Plugin  │
│  (Claude,     │                  │  (Node.js /  │   .jsx commands    │  (runs inside │
│   Windsurf,   │                  │   TypeScript) │   .json responses  │   Premiere)   │
│   Cursor)     │                  └──────────────┘                    └──────┬────────┘
└───────────────┘                                                             │ evalScript()
                                                                              ▼
                                                                       ┌──────────────┐
                                                                       │  Premiere Pro │
                                                                       │  ExtendScript │
                                                                       │  + QE DOM     │
                                                                       └──────────────┘

远程（HTTP/SSE-Fly.io）：

┌───────────────┐  HTTP+SSE (MCP)  ┌─────────────────────┐   File-based IPC   ┌──────────────┐
│  AI Client    │ ◄───────────────► │  MCP Server         │ ◄────────────────► │  CEP Plugin  │
│  (any MCP     │                   │  premiere-pro-mcp   │   .jsx / .json     │  (Premiere)  │
│   client)     │                   │  .fly.dev           │   shared volume    └──────────────┘
└───────────────┘                   └─────────────────────┘

1. AI客户端调用MCP工具（例如。， add_to_timeline)
2. MCP服务器生成与ES3兼容的ExtendScript，并添加了辅助函数
3. 脚本被写入 .jsx 共享临时目录中的命令文件
4. CEP插件轮询命令文件，通过执行 CSInterface.evalScript()
5. 结果JSON被写入响应文件并返回给AI

基于文件的IPC桥简单、可靠，无需网络套接字即可在macOS和Windows上工作。

______________________________________________________________________

工具（269）

发现与检查（10+10）

项目管理（26）

时间线和编辑（10+27高级）

效果与色彩（8）

关键帧（8）

导出和编码（14）

源监控和播放（7+4）

选择和剪贴板（7+6）

媒体属性（16）

序列管理（11）

工作区和标题（2+1）

脚本（6）

…以及100多个

跟踪目标、批处理操作、标记、音频级别、运动/变换、元数据、序列设置、导航、项目分析等。跑 get_project_info 首先，人工智能将发现它需要什么。

______________________________________________________________________

MCP资源

服务器公开了两个LLM上下文资源：

这些内容会自动提供给支持资源的MCP客户端，为人工智能提供有关如何有效驱动Premiere Pro的深入背景。

______________________________________________________________________

远程部署（Fly.io）

服务器包括HTTP/SSE传输(src/http-server.ts)通过以下方式进行远程访问 mcp遥控器 或支持流式HTTP的任何MCP客户端。

一个实时实例正在运行 https://premiere-pro-mcp.fly.dev.

通过mcp远程连接

{
  "mcpServers": {
    "premiere-pro": {
      "command": "npx",
      "args": ["mcp-remote", "https://premiere-pro-mcp.fly.dev/mcp"]
    }
  }
}

Fly.io上的自助主机

# Clone and deploy your own instance
git clone https://github.com/ppmcp/premiere-pro-mcp.git
cd premiere-pro-mcp
fly apps create your-app-name
fly deploy --remote-only

# Optional: add bearer token auth
fly secrets set MCP_AUTH_TOKEN=your-secret-token

然后连接：

{
  "mcpServers": {
    "premiere-pro": {
      "command": "npx",
      "args": ["mcp-remote", "https://your-app-name.fly.dev/mcp",
               "--header", "Authorization: Bearer your-secret-token"]
    }
  }
}

注： 文件桥仍然需要CEP插件共享相同的文件 PREMIERE_TEMP_DIR。对于云部署，这意味着运行同步代理或使用 fly proxy /WireGuard连接到您的本地机器。

______________________________________________________________________

环境变量

______________________________________________________________________

项目结构

premiere-pro-mcp/
├── src/
│   ├── index.ts                 # Entry point — stdio transport setup
│   ├── http-server.ts           # Entry point — HTTP/SSE transport (Fly.io / remote)
│   ├── server.ts                # MCP server — registers all 269 tools + 2 resources
│   ├── bridge/
│   │   ├── file-bridge.ts       # File-based IPC (write .jsx, poll .json)
│   │   └── script-builder.ts    # ExtendScript generator with ES3 helpers
│   ├── tools/                   # 28 tool modules
│   │   ├── discovery.ts         # Project discovery and queries
│   │   ├── project.ts           # Project management and import
│   │   ├── media.ts             # Media and proxy management
│   │   ├── sequence.ts          # Sequence creation and settings
│   │   ├── timeline.ts          # Timeline clip operations
│   │   ├── effects.ts           # Effect application and color correction
│   │   ├── transitions.ts       # Transition management (QE DOM)
│   │   ├── audio.ts             # Audio levels and keyframes
│   │   ├── text.ts              # Text overlays and MOGRTs
│   │   ├── markers.ts           # Sequence and clip markers
│   │   ├── tracks.ts            # Track add/delete/lock/visibility
│   │   ├── playhead.ts          # Playhead, work area, in/out points
│   │   ├── metadata.ts          # Metadata, XMP, color labels
│   │   ├── export.ts            # Export, frame capture, encoding
│   │   ├── advanced.ts          # QE DOM: ripple, roll, slide, slip, speed
│   │   ├── keyframes.ts         # Keyframe CRUD and interpolation
│   │   ├── scripting.ts         # Execute arbitrary ExtendScript
│   │   ├── inspection.ts        # Deep project/sequence/clip inspection
│   │   ├── selection.ts         # Clip selection utilities
│   │   ├── clipboard.ts         # Copy effects, batch operations
│   │   ├── source-monitor.ts    # Source monitor control
│   │   ├── track-targeting.ts   # Track targeting, motion, audio props
│   │   ├── utility.ts           # Batch ops, analysis, navigation
│   │   ├── health.ts            # Connectivity ping
│   │   ├── workspace.ts         # Workspace layout switching
│   │   ├── captions.ts          # Caption track creation
│   │   ├── playback.ts          # Timeline/source playback control
│   │   └── project-manager.ts   # Project consolidation/transfer
│   └── resources/
│       └── extendscript-reference.ts  # API reference for LLM context
├── cep-plugin/                  # CEP panel that runs inside Premiere Pro
│   ├── CSXS/manifest.xml        # Extension manifest (PPRO 14.0+)
│   ├── index.html               # Panel UI
│   ├── main.js                  # Bridge polling and script execution
│   ├── host.jsx                 # ExtendScript entry point
│   └── CSInterface.js           # Adobe CEP interface library
├── scripts/
│   └── install-cep.sh           # CEP plugin installer (symlink + debug mode)
├── Dockerfile                   # Multi-stage Docker build for Fly.io
├── fly.toml                     # Fly.io deployment config
├── RESEARCH.md                  # API research and implementation status
├── CONTRIBUTING.md              # Contribution guidelines
├── CHANGELOG.md                 # Version history
└── LICENSE                      # MIT License

______________________________________________________________________

技术细节

为什么选择CEP而不是UXP？

CEP（通用可扩展性平台）在Premiere Pro中提供完整的ExtendScript访问权限，包括未记录的 QE DOM --这是按名称应用效果、执行波纹删除和执行高级修剪操作的唯一方法。Premiere Pro中的UXP仍在成熟，缺乏同等的API覆盖范围。CEP在各地开展工作 2020年至2025年首映+.

ExtendScript兼容性

所有生成的脚本都使用 ES3语法 (var，手册 for 循环，没有箭头函数，没有 let/const)因为ExtendScript基于ECMAScript 3。这 buildToolScript() 函数为每个脚本添加一个辅助函数库。

安全

• 脚本在执行前经过验证——块 eval(), new Function(), System.callSystem()
• 500KB脚本大小限制
• send_raw_script 绕过高级用户的验证（通过明确的选择加入）
• 使用受限权限创建的临时目录（模式700）

QE DOM

许多工具使用未记录的QE DOM（通过启用 app.enableQE()).这些工具在描述中标记为“使用QE DOM”。QE DOM提供了标准ExtendeScript API无法提供的功能：

• 按名称应用效果和过渡
• 涟漪删除、滚动/滑动/滑动编辑
• 设置剪辑速度和倒档
• 帧混合和时间插值
• 从剪辑中删除所有效果

______________________________________________________________________

故障排除

CEP plugin doesn't appear in Premiere Pro

1. 验证调试模式： defaults read com.adobe.CSXS.12 PlayerDebugMode 应返回 1
2. 检查插件是否存在： ls ~/Library/Application\ Support/Adobe/CEP/extensions/MCPBridgeCEP
3. 完全重启Premiere Pro（不仅仅是关闭/重新打开项目）
4. 检查CSXS版本是否与您的Premiere Pro版本匹配

Commands timeout or hang

1. 验证CEP面板是否显示带绿点的“正在运行”
2. 确保MCP客户端配置和CEP面板之间的临时目录匹配
3. 检查Premiere Pro是否繁忙（渲染，模态对话框打开）
4. 增加超时：设置 PREMIERE_TIMEOUT_MS 到 60000 或更高
5. 尝试 ping 测试基本连接的工具

AI client can't see tools

1. 编辑配置后重新启动AI客户端
2. 验证路径 dist/index.js 绝对正确
3. 跑 node dist/index.js 在终端中检查启动错误
4. 确保 npm run build 已完成，无错误

QE DOM tools fail

1. QE工具需要一个活动序列——先打开一个
2. 一些量化宽松操作是基于索引的，如果剪辑被重新排序，可能会失败
3. QE操作后重新查询序列结构

______________________________________________________________________

贡献

欢迎投稿！看 贡献.md 作为指导方针。

______________________________________________________________________

许可证

麻省理工学院 --免费用于个人和商业用途。