Premiere Pro MCP服务器

为Adobe Premiere Pro提供的MCP兼容服务器,支持高级自动化、查询和远程控制项目,适用于高级用户、工作流自动化以及与AI或脚本工具的集成。

  • by jordanl61
  • JavaScript
  • 本地部署
  • 14 星标
  • 更新于
在 GitHub 查看 jordanl61/premiere-pro-mcp-server

使用说明

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扩展

  1. 找到扩展文件夹
    (通常命名为 com.yourcompany.premiere-mcp)

  2. 将文件夹复制到Adobe CEP扩展目录:

    • 窗户:
      %APPDATA%\Adobe\CEP\extensions
      
    • macOS:
      ~/Library/Application Support/Adobe/CEP/extensions
      
  3. 启用开发人员模式 在Adobe应用程序中:

    • 打开Creative Cloud应用程序
    • 转到“首选项”→ “插件”→ 启用“开发人员模式”
    • 或者,对于旧版本,设置 PlayerDebugMode 注册表项(请参见 Adobe CEP/入门)
  4. 重新启动Premiere Pro

    • 打开应用程序,转到 Window > Extensions 然后选择您的面板。

2.安装并运行MCP服务器

  1. 安装依赖项
    (例如,对于Node.js: npm install 或者对于Python: pip install -r requirements.txt)

  2. 启动服务器
    (例如。, npm start, node server.js,或 python server.py)

    默认情况下,服务器运行在 localhost:PORT (将PORT替换为您的配置,例如5000)。

  3. 保持服务器运行 在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制作、认可或支持的。