Adobe Premiere Pro MCP

🚀 MCP Adobe Premiere Pro — AI视频编辑自动化

本项目是一个由AI驱动的自动化桥梁，可用于Adobe Premiere Pro。借助模型上下文协议（MCP），你可以使用自然语言控制编辑操作，并借助Claude或其他AI代理实现工作流程自动化。

🚀 快速开始

1. 克隆并安装

git clone https://github.com/hetpatel-11/Adobe_Premiere_Pro_MCP
cd MCP_Adobe_Premiere_Pro
npm install

2. 构建并启动MCP服务器

npm run build
npm start

3. 在Premiere Pro中安装CEP扩展

1. 复制PremiereRemote扩展文件夹 到你的Adobe CEP扩展目录：
   • macOS：~/Library/Application Support/Adobe/CEP/extensions/
   • Windows：%APPDATA%/Adobe/CEP/extensions/
2. 启用加载未签名扩展：
   • macOS：编辑~/Library/Preferences/com.adobe.CSXS.9.plist，并将PlayerDebugMode设置为1。
   • Windows：使用regedit在HKEY_CURRENT_USER/Software/Adobe/CSXS.9下将PlayerDebugMode设置为1。
   • CEP调试指南
3. 重启Premiere Pro。
4. 打开扩展：
   • 转到窗口 > 扩展（旧版） > PremiereRemote。
   • 如果桥梁正在运行，面板应显示“就绪！”

4. 连接Claude（或其他AI代理）

• 配置Claude以使用MCP服务器作为工具端点。
• 要求Claude执行编辑任务（请参阅下面支持的功能）。

✨ 主要特性

本项目是一个 由AI驱动的Adobe Premiere Pro自动化桥梁。它通过MCP公开了一组编辑工具，让你可以：

• 🗣️ 与编辑器对话（通过Claude或其他AI代理）
• ⚡ 自动化重复性任务
• 🧠 构建更智能、具有上下文感知的工作流程

📦 安装指南

使用UXP DevTools（实验性）

你还可以将此项目作为Premiere Pro（24.4+）中的UXP面板使用：

1. 打开 Adobe UXP DevTools。
2. 点击“添加插件”并选择uxp-plugin/文件夹。
3. 在DevTools中启动面板，并通过窗口 > 插件 > MCP Bridge (UXP)在Premiere Pro中打开它。

⚠️ 注意：

• Premiere Pro中的UXP脚本编写是 实验性的且有局限性。某些功能（如时间轴和序列编辑）可能尚未可用。
• 如需完整的自动化功能，请使用CEP（旧版）面板。

💻 使用示例

基础用法

你可以通过Claude或其他AI代理与编辑器对话，例如要求Claude执行编辑任务，如创建项目、导入媒体等。以下是一些调用支持工具的示例：

# 假设通过某种接口调用MCP服务器来执行操作
# 创建一个新的Premiere Pro项目
# create_project()

# 导入一个媒体文件
# import_media('path/to/media.mp4')

高级用法

你可以构建更复杂的工作流程，例如创建多机位序列、自动根据音乐节拍编辑视频等：

# 创建一个多机位序列
# create_multicam_sequence(['path/to/clip1.mp4', 'path/to/clip2.mp4'])

# 自动根据音乐节拍编辑视频
# auto_edit_to_music('path/to/music.mp3', 'path/to/video.mp4')

📚 详细文档

🛠️ 支持的工具

📁 项目管理

• create_project — 创建一个新的Premiere Pro项目
• open_project — 打开一个现有的项目文件
• save_project — 保存当前项目
• save_project_as — 使用新的名称/位置保存项目

📂 媒体管理

• import_media — 导入一个媒体文件（视频、音频、图像）
• import_folder — 从一个文件夹导入所有媒体文件
• create_bin — 在项目面板中创建一个新的文件夹

🎬 序列管理

• create_sequence — 创建一个新的序列（时间轴）
• duplicate_sequence — 复制一个现有的序列
• delete_sequence — 删除一个序列

⏱️ 时间轴操作

• add_to_timeline — 将一个媒体剪辑添加到序列时间轴
• remove_from_timeline — 从时间轴中移除一个剪辑
• move_clip — 将一个剪辑移动到不同的位置
• trim_clip — 调整一个剪辑的入/出点
• split_clip — 在特定时间点分割一个剪辑

🎨 效果与过渡

• apply_effect — 将视觉或音频效果应用于一个剪辑
• remove_effect — 从一个剪辑中移除一个效果
• add_transition — 在两个剪辑之间添加一个过渡
• add_transition_to_clip — 在一个剪辑的开始或结束处添加一个过渡

🔊 音频操作

• adjust_audio_levels — 调整一个音频剪辑的音量
• add_audio_keyframes — 为音频级别添加关键帧
• mute_track — 静音或取消静音整个音频轨道

🎛️ 色彩校正

• color_correct — 应用基本的色彩校正调整
• apply_lut — 将查找表（LUT）应用于一个剪辑

📤 导出与渲染

• export_sequence — 渲染并将一个序列导出为视频文件
• export_frame — 将单个帧导出为图像

🎥 高级功能

• create_multicam_sequence — 从多个视频剪辑创建一个多机位序列
• create_proxy_media — 生成媒体的代理版本
• auto_edit_to_music — 自动根据音乐节拍编辑视频
• stabilize_clip — 应用视频稳定效果
• speed_change — 更改一个剪辑的播放速度

🔍 项目/媒体/序列发现

• list_project_items — 列出项目中的所有媒体项、文件夹和资产
• list_sequences — 列出项目中的所有序列
• list_sequence_tracks — 列出一个序列中的所有轨道
• get_project_info — 获取全面的项目信息

⚠️ 不支持的功能（原因）

❌ 不支持（Adobe脚本编写限制）

• add_text_overlay — 文本覆盖（旧版标题）在现代Premiere Pro脚本编写中已弃用/损坏
• add_shape — 形状/图形覆盖不被Premiere脚本编写支持
• Essential Graphics (MOGRTs) — 不可脚本化
• Direct pixel manipulation — 不可能实现

原因：Adobe已移除或弃用了这些脚本编写API。只有上述功能可以可靠地进行脚本编写。

🔧 技术细节

本项目旨在探索AI驱动的视频编辑自动化在Premiere Pro中的应用边界。通过MCP协议，项目将AI代理（如Claude）与Premiere Pro的编辑工具进行桥接，从而实现通过自然语言控制编辑操作和自动化工作流程。

然而，项目也面临一些限制。Adobe脚本编写的局限性导致部分功能（如文本覆盖、形状图形覆盖等）无法实现，同时一些脚本API存在漏洞或版本依赖问题。此外，CEP扩展在最新的Adobe应用中已被弃用，UXP脚本编写在Premiere Pro中仍处于实验阶段。

尽管如此，该项目为自动化重复性编辑任务、构建更智能的AI工作流程提供了一个很好的起点。

📄 许可证

文档中未提及相关许可证信息。

🐞 已知问题与局限性

• 文本/图形覆盖不起作用（见上文）
• 某些脚本API存在漏洞或依赖于版本
• CEP扩展在最新的Adobe应用中已被弃用（但目前仍可使用）
• Premiere Pro中的UXP脚本编写是实验性的且有局限性（见上文）
• 由于Premiere脚本编写的特性，错误处理虽然强大，但某些失败可能无提示
• 这是一个概念验证/起点 — 并非成熟的商业产品

💡 项目存在的原因

我想了解AI驱动的视频编辑自动化在Premiere Pro中能走多远。虽然存在实际的局限性，但这个项目是以下方面的一个很好的起点：

• 自动化重复性的编辑任务
• 构建更智能的AI工作流程
• 探索Adobe脚本编写的可能性边界

如果你想进一步实现高级图形/文本功能，你需要使用After Effects脚本编写、Photoshop或第三方插件。

📚 参考资料

• Adobe Premiere Pro脚本编写指南
• Adobe CEP资源

🙏 感谢与贡献

如果你觉得这个项目有用或想做出贡献，请随时提出问题或提交拉取请求。欢迎提供真诚的反馈和改进建议！