使用说明
Premiere Pro MCP服务器
Adobe Premiere Pro的非官方MCP(模型上下文协议)服务器
概述
此项目提供了一个兼容MCP的服务器,可实现Adobe Premiere Pro项目的高级自动化、查询和远程控制。它专为高级用户、工作流自动化以及与AI或脚本工具的集成而设计。
免责声明
这个项目是 不隶属于Adobe股份有限公司、由Adobe公司背书或由Adobe公司支持。 无论如何。它是独立开发的第三方工具,用于Adobe Premiere Pro。
使用风险自负。 对于功能、兼容性或安全性不作任何保证。作者对使用本软件可能导致的任何损失、损坏或数据损坏不承担任何责任。
使用前务必备份您的项目。
功能和可用工具
服务器通过MCP API公开以下工具:
- get_project_info:获取当前Premiere Pro项目的基本信息
- 获取活动序列信息:获取当前活动序列的详细信息
- list_all_sequences:列出当前项目中的所有序列及其基本信息
- 获取序列详细信息:获取特定序列的详细信息,包括轨迹、效果和标记
- get_timeline_structure:获取活动序列的轨迹结构
- get_timeline_clips:获取活动序列中包含详细信息的所有剪辑
- get_project_media:获取项目浏览器中包含文件信息的所有媒体项
- get_project_bins:获取项目仓位结构和组织
- get_playhead_info:获取当前播放头位置和播放状态
- get_selection_info:获取当前选定剪辑或时间范围的信息
- get_export_presets:获取可用的导出预设及其设置
- get_nder_queue:获取当前渲染队列状态和项目
- 创建序列:在Premiere Pro中创建新序列
- 出口工程:导出当前项目或序列
- trim_clip_by_frames:将视频或音频剪辑的输入/输出点修剪(或扩展)指定帧数。
- 参数:sequenceId、clipId、framesDelta、方向(“in”|“out”)、trackType(“video”|“audio”)
UI集成示例
要添加按帧修剪剪辑的UI,请在CEP面板中包含以下代码段:
<div>
<label>Track Type:
<select id="trackType">
<option value="video">Video</option>
<option value="audio">Audio</option>
</select>
</label>
<label>Direction:
<select id="direction">
<option value="in">In</option>
<option value="out">Out</option>
</select>
</label>
<label>Frames Delta:
<input type="number" id="framesDelta" value="10" />
</label>
<button onclick="trimClipUI()">Trim Clip</button>
</div>
<script>
async function trimClipUI() {
// Replace with actual logic to get selected sequence/clip IDs
const sequenceId = 0; // Example: active sequence index
const clipId = getSelectedClipId(); // Implement this function based on your panel logic
const framesDelta = parseInt(document.getElementById('framesDelta').value, 10);
const direction = document.getElementById('direction').value;
const trackType = document.getElementById('trackType').value;
const response = await fetch('http://localhost:5000/trim_clip_by_frames', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ sequenceId, clipId, framesDelta, direction, trackType })
});
const result = await response.json();
alert(result.content[0].text);
}
</script>
替换 getSelectedClipId() 您获取所选剪辑的实际逻辑。
- Adobe Premiere Pro(在最新版本上测试)
- Node.js(推荐LTS)
- MCP兼容客户端(可选,用于自动化)
什么是CEP?
Adobe CEP(通用可扩展性平台)是一种在Adobe Creative Cloud应用程序(如Premiere Pro、After Effects和Photoshop)中启用自定义面板和扩展的技术。
在以下网址了解更多信息并查找开发人员资源 Adobe CEP GitHub组织.
先决条件
在开始之前,请确保您已经:
- 视频编辑软件 (或兼容的Adobe应用程序)
- Node.js (如果MCP服务器是基于节点的)或Python(如果是基于Python的)
- 访问Premiere MCP服务器代码
- CEP扩展文件 (包含在本回购中或单独提供)
安装和使用指南
1.安装CEP扩展
-
找到扩展文件夹
(通常命名为com.yourcompany.premiere-mcp) -
将文件夹复制到Adobe CEP扩展目录:
- 窗户:
%APPDATA%\Adobe\CEP\extensions - macOS:
~/Library/Application Support/Adobe/CEP/extensions
- 窗户:
-
启用开发人员模式 在Adobe应用程序中:
- 打开Creative Cloud应用程序
- 转到“首选项”→ “插件”→ 启用“开发人员模式”
- 或者,对于旧版本,设置
PlayerDebugMode注册表项(请参见 Adobe CEP/入门)
-
重新启动Premiere Pro
- 打开应用程序,转到
Window > Extensions然后选择您的面板。
- 打开应用程序,转到
2.安装并运行MCP服务器
-
安装依赖项
(例如,对于Node.js:npm install或者对于Python:pip install -r requirements.txt) -
启动服务器
(例如。,npm start,node server.js,或python server.py)默认情况下,服务器运行在
localhost:PORT(将PORT替换为您的配置,例如5000)。 -
保持服务器运行 在Premiere Pro中使用扩展时。
3.配置扩展(如果需要)
- 如果您的扩展需要指定服务器URL/端口,请编辑配置文件或使用面板的设置。
4.故障排除
-
状态:错误:无法获取
这意味着MCP服务器未运行或无法访问。- 确保服务器已启动,并且与扩展所需的端口匹配。
- 检查防火墙/防病毒设置。
-
面板未出现在首映式中
- 确认扩展名位于正确的目录中。
- 必须启用开发人员模式。
- 安装后重新启动Premiere。
-
更多帮助:
看 Adobe CEP/入门 和 Adobe CEP 获取更多文档和故障排除提示。
Premiere MCP服务器安装和使用指南
1.先决条件
- 视频编辑软件 (已安装最新或支持的版本)
- Node.js (推荐LTS版本)
- npm (附带Node.js)
- (可选) 克劳德桌面 或任何支持MCP服务器集成的AI IDE
2.安装步骤
a.克隆存储库
git clone https://github.com/yourusername/premiere-mcp-server.git
cd premiere-mcp-server
b.安装依赖项
npm install
3.运行服务器
启动MCP服务器:
node mcp-server.js
- 服务器应输出一条消息,指示其正在运行并侦听MCP连接。
4.连接到克劳德桌面或AI IDE
a.打开克劳德桌面(或您的AI IDE)。
b.将Premiere MCP服务器添加为新的MCP服务器:
- 在Claude Desktop中,转到MCP服务器设置或集成面板。
- 输入MCP服务器的地址(通常
http://localhost:PORT--替换PORT使用您的服务器使用的端口。,http://localhost:3000). - 保存或应用设置。
c.测试连接:
- Claude Desktop(或您的IDE)现在应该列出Premiere MCP服务器及其可用工具。
- 尝试运行一个简单的命令(如
get_project_info)以验证连接。
5.使用工具
- 连接后,您可以直接从AI IDE或自动化脚本调用任何可用工具(见上文)。
- 示例:要求Claude Desktop“列出所有序列”或“导出当前项目”
6.故障排除
- 服务器未连接?
- 确保Premiere Pro正在运行。
- 确保MCP服务器正在运行(终端中没有错误)。
- 仔细检查IDE中的服务器URL和端口。
- 如果使用防火墙,请确保端口打开。
7.安全与免责声明
- 此项目不隶属于Adobe或得到Adobe的认可。
- 使用风险自负。始终备份您的项目。
- 作者不对任何数据丢失或问题提供任何保证或支持。
许可证
该项目根据MIT许可证获得许可。请参阅 许可证 文件以获取详细信息。
此项目不是由Adobe制作、认可或支持的。