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資源

🙏 感謝與貢獻

如果你覺得這個項目有用或想做出貢獻，請隨時提出問題或提交拉取請求。歡迎提供真誠的反饋和改進建議！