首映Pro MCP服务器

Name: 首映Pro MCP服务器
Author: jordanl61

作者：jordanl616 星标更新：2025-07-08

安装使用来源：spider==github.com

项目介绍

Adobe Premiere Pro MCP 服务器

Premiere Pro 时间线示例

非官方的 Adobe Premiere Pro MCP (模型上下文协议) 服务器

概述

该项目提供了一个与 MCP 兼容的服务器，使用户能够对 Adobe Premiere Pro 项目进行高级自动化、查询和远程控制。它专为高级用户、工作流自动化以及与 AI 或脚本工具集成而设计。

免责声明
本项目未得到 Adobe Inc. 的任何形式的支持、认可或赞助。这是一个独立开发的第三方工具，用于与 Adobe Premiere Pro 配合使用。
自行承担风险使用。对于功能、兼容性或安全性不作任何保证。作者不对因使用此软件而导致的任何损失、损害或数据损坏承担责任。
使用前务必备份您的项目。

功能及可用工具

该服务器通过 MCP API 提供以下工具：

get_project_info: 获取当前 Premiere Pro 项目的基本信息
get_active_sequence_info: 获取当前活动序列的详细信息
list_all_sequences: 列出当前项目中的所有序列及其基本信息
get_sequence_details: 获取特定序列的详细信息，包括轨道、效果和标记
get_timeline_structure: 获取活动序列的轨道结构
get_timeline_clips: 获取活动序列中的所有片段及其详细信息
get_project_media: 获取项目浏览器中的所有媒体项及其文件信息
get_project_bins: 获取项目存储库的结构和组织
get_playhead_info: 获取当前播放头位置和播放状态
get_selection_info: 获取当前选中的片段或时间范围的信息
get_export_presets: 获取可用的导出预设及其设置
get_render_queue: 获取当前渲染队列的状态和项目
create_sequence: 在 Premiere Pro 中创建新的序列
export_project: 导出现有项目或序列
trim_clip_by_frames: 根据指定的帧数修剪（或延长）视频或音频片段的入点或出点。
- 参数：sequenceId, clipId, framesDelta, direction ('in'|'out'), trackType ('video'|'audio')

用户界面集成示例

要在面板中添加一个按帧修剪片段的 UI，请在您的 CEP 面板中包含以下代码片段：

<div>
  <label>轨道类型：
    <select id="trackType">
      <option value="video">视频</option>
      <option value="audio">音频</option>
    </select>
  </label>
  <label>方向：
    <select id="direction">
      <option value="in">入点</option>
      <option value="out">出点</option>
    </select>
  </label>
  <label>帧数差：
    <input type="number" id="framesDelta" value="10" />
  </label>
  <button onclick="trimClipUI()">修剪片段</button>
</div>
<script>
async function trimClipUI() {
  // 替换为实际逻辑以获取选定序列/片段 ID
  const sequenceId = 0; // 示例：活动序列索引
  const clipId = getSelectedClipId(); // 根据您的面板逻辑实现此函数
  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 创意云应用程序（如 Premiere Pro、After Effects 和 Photoshop）中自定义面板和扩展的技术。
更多详情和开发者资源请访问 Adobe CEP GitHub 组织。

前提条件

开始之前，请确保您拥有：

Adobe Premiere Pro（或其他兼容的 Adobe 应用程序）
Node.js（如果 MCP 服务器基于 Node.js）或 Python（如果基于 Python）
访问 Premiere MCP 服务器代码
CEP 扩展文件（包含在此仓库中或单独提供）

安装及使用指南

1. 安装 CEP 扩展

定位扩展文件夹
（通常命名为类似 com.yourcompany.premiere-mcp 的名称）

将文件夹复制到 Adobe CEP 扩展目录：

Windows:
```
%APPDATA%\Adobe\CEP\extensions
```

macOS:

~/Library/Application Support/Adobe/CEP/extensions

在 Adobe 应用程序中启用开发者模式：
- 打开创意云应用程序
- 转到首选项 → “插件” → 启用“开发者模式”
- 或者，对于旧版本，设置 PlayerDebugMode 注册表键（参见 Adobe-CEP/Getting-Started）
重启 Premiere Pro
- 打开应用程序，转到 窗口 > 扩展 并选择您的面板。

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 中
- 确认扩展位于正确的目录中。
- 必须启用开发者模式。
- 安装后重启 Premiere。
更多帮助：
查看 Adobe-CEP/Getting-Started 和 Adobe-CEC 以获取额外的文档和故障排除提示。

Premiere MCP 服务器的安装及使用指南

1. 前提条件

Adobe Premiere Pro（安装了最新或支持的版本）
Node.js（推荐 LTS 版本）
npm（随 Node.js 一起提供）
（可选）Claude Desktop 或任何支持 MCP 服务器集成的 AI 开发环境

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. 连接到 Claude Desktop 或 AI 开发环境

a. 打开 Claude Desktop（或您的 AI 开发环境）。

b. 将 Premiere MCP 服务器作为新 MCP 服务器添加：

在 Claude Desktop 中，转到 MCP 服务器设置或集成面板。
输入您的 MCP 服务器地址（通常是 http://localhost:PORT — 替换 PORT 为您服务器使用的端口，例如 http://localhost:3000）。
保存或应用设置。

c. 测试连接：

Claude Desktop（或您的开发环境）现在应该列出 Premiere MCP 服务器及其可用工具。
尝试运行一个简单的命令（如 get_project_info）来验证连接。

5. 使用工具

一旦连接成功，您可以从您的 AI 开发环境或自动化脚本中直接调用任何可用工具（参见上文）。
示例：让 Claude Desktop “列出所有序列” 或 “导出现有项目”。

6. 故障排除

服务器无法连接？
- 确保 Premiere Pro 正在运行。
- 确保 MCP 服务器正在运行（终端中无错误）。
- 再次检查开发环境中的服务器 URL 和端口。
- 如果使用防火墙，请确保端口是开放的。

7. 安全及免责声明

本项目未得到 Adobe 的支持、认可或赞助。
自行承担风险使用。始终备份您的项目。
作者不对任何数据丢失或问题提供保证或支持。

许可证

本项目根据 MIT 许可证发布。详情请参阅 LICENSE 文件。

本项目未由 Adobe 生产、认可或支持。