Premiere Pro Full MCP v0.2.0

English · 한국어

Premiere Pro Full MCP ist ein lokaler, fähigkeitsgesteuerter MCP-Server für Adobe Premiere Pro 2026 unter Windows. Er kombiniert die dokumentierte Premiere-UXP-API, eine eingeschränkte CEP/ExtendScript-Brücke, experimentelle QE-Erkennung und einen fail-closed nativen Windows-UI-Agenten.

Dies ist ein inoffizielles Community-Projekt und steht in keiner Verbindung zu Adobe Inc. und wird von diesem nicht unterstützt. „Full“ bedeutet, dass die unterstützte API-Oberfläche inventarisiert und geroutet wird; es bedeutet nicht, dass jede UI-Funktion in jedem Host-Zustand skriptbar ist.

English

Schnellstart für Windows

Anforderungen: Windows 10/11 x64, Premiere Pro 26.3 oder höher, Creative Cloud Desktop und Codex Desktop oder die Codex-CLI. Node.js ist für die gepackte Laufzeit nicht erforderlich.

1. Laden Sie premiere-pro-full-mcp-v0.2.0-windows.zip aus dem neuesten Release herunter. Überprüfen Sie die danebenliegende .sha256-Datei und extrahieren Sie sie dann.

2. Schließen Sie Premiere Pro, öffnen Sie PowerShell im extrahierten Ordner premiere-pro-full-mcp-0.2.0 und führen Sie Folgendes aus:

   powershell -NoProfile -ExecutionPolicy Bypass -File .\Install.ps1

   Der Installer überprüft jede gepackte Datei, installiert nur im aktuellen Benutzerprofil, registriert premiere_pro_full_mcp bei Codex und öffnet die gebündelte CCX.

3. Genehmigen Sie die Warnung für unabhängige Plugins in Creative Cloud Desktop. Starten Sie Premiere neu und öffnen Sie dann Fenster > UXP-Plugins > Premiere Pro Full MCP.

4. Klicken Sie bei der ersten Verwendung auf Pair with installed helper… und wählen Sie %LOCALAPPDATA%\PremiereMCP\app\runtime-bootstrap.json aus. UXP merkt sich nur die Dateiberechtigung; das Sitzungstoken wird nicht in der CCX gespeichert.

5. Starten Sie Codex neu und rufen Sie die Host-/Fähigkeitsprüfungswerkzeuge auf. Führen Sie Doctor aus, wenn die Brücke nicht verbunden ist:

   powershell -NoProfile -ExecutionPolicy Bypass -File "$env:LOCALAPPDATA\PremiereMCP\app\tools\Doctor.ps1" -CheckLive

Die ausführbaren Dateien und PowerShell-Skripte sind nicht Authenticode-signiert. Windows zeigt möglicherweise SmartScreen-Warnungen an. Das Release verwendet ein separates RSA-signiertes Update-Manifest, exakte Asset-Größen/SHA-256-Bindungen und ein SHA-256-Manifest im Paket. Die gebündelte CEP-Kompatibilitätsbrücke trägt eine Adobe-ZXP-Paketsignatur, sodass die Installation den CEP-Entwicklermodus nicht aktiviert. Der anfängliche Download hängt weiterhin von GitHub-HTTPS und der veröffentlichten Prüfsumme ab; umgehen Sie eine Warnung nicht, wenn die Prüfsumme oder Quelle unerwartet ist.

Update und Deinstallation

# Download and install the newest authenticated GitHub release
powershell -NoProfile -ExecutionPolicy Bypass -File "$env:LOCALAPPDATA\PremiereMCP\app\tools\Update.ps1"

# Recoverable removal; pairing/workspace data is preserved
powershell -NoProfile -ExecutionPolicy Bypass -File "$env:LOCALAPPDATA\PremiereMCP\app\tools\Uninstall.ps1"

Updates lehnen Abweichungen bei Signatur, Repository, Tag, Name, Größe, Digest, Prerelease und Downgrade ab. Entfernen Sie die CCX separat in Creative Cloud Desktop > Plugins > Plugins verwalten.

Sicherheits- und Fähigkeitsvertrag

• Dokumentierte UXP wird bevorzugt. CEP füllt typisierte Kompatibilitätslücken, QE ist experimentell und Windows-UI-Automatisierung ist die letzte Option.

• Fehlgeschlagene Mutationen werden niemals automatisch über ein anderes Backend erneut abgespielt.

• Der Sequenzexport verwendet den dokumentierten UXP-Encoder-Pfad, vertraut jedoch keinem Host-Promise, das nach dem Rendern ausstehend bleiben kann; Erfolg erfordert eine geänderte, nicht leere Ausgabedatei, die über wiederholte Beobachtungen stabil bleibt. Vorhandene Ausgaben werden abgelehnt, es sei denn, eine ausdrücklich genehmigte Überschreibungsrichtlinie ist implementiert.

• R2/R3-Operationen verwenden kurzlebige, bereichsgebundene, einmalige Genehmigungs-IDs und einen unabhängigen vertrauenswürdigen Windows-Dialog.

• Rohes ExtendScript, beliebige QE-/Objektpfade, rohe UI-Selektoren/Klicks, Shell-Befehle und die Extraktion von Anmeldeinformationen sind keine öffentlichen MCP-Operationen.

• Listener binden an localhost, CEP-Envelopes werden über einen DPAPI-CurrentUser-Broker mit HMAC authentifiziert, und Release-Artefakte enthalten niemals Laufzeit-Bootstrap-Material.

• Dateisystemarbeiten sind auf ausdrücklich genehmigte kanonische Wurzeln beschränkt und lehnen Reparse-Point-Escapes ab.

• Es werden keine Telemetriedaten erfasst. Protokolle und Journale schließen Eingabeaufforderungen, Argumente, Ergebnisse, Token, Projektpfade, Mediennnamen und persönliche Kennungen aus.

Das generierte Adobe-26.3-Inventar enthält 69 Wurzeln und 761 aufrufbare Member. Die endgültige Live-Vollflächen-Baseline stimmte mit allen 761 IDs überein. Von 312 deterministischen schreibgeschützten Aufrufen, die versucht wurden, waren 281 erfolgreich und 31 schlugen geschlossen fehl, weil die erforderliche Methode, Wurzel oder Sitzungshandle nicht verfügbar war. Weitere 151 risikobehaftete Einträge waren nur Vorschau und 298 kontextabhängige Einträge wurden mit expliziten Gründen übersprungen. Siehe Live-Validierung.

Entwicklung

Anforderungen: Node.js 20.19+ (Node 24 bevorzugt), .NET 8 SDK, Premiere Pro 26.3+ und Adobe UXP Developer Tool.

npm ci
npm run inventory:adobe
npm run check
npm run test:coverage
dotnet test .\windows-ui-agent\tests\PremiereMcp.WindowsUiAgent.Tests.csproj --configuration Release
npm run validate:uxp-plan

Release-Builds erfordern einen sauberen Git-Worktree und den dedizierten privaten Signaturschlüssel unter %LOCALAPPDATA%\PremiereMCP. Der private Schlüssel wird niemals committet oder auf GitHub Actions hochgeladen. Siehe Bereitstellung, Sicherheit und Mitwirken.

Related MCP server: MCP Adobe Premiere Pro

한국어

Windows 빠른 설치

요구 사항은 Windows 10/11 x64, Premiere Pro 26.3 이상, Creative Cloud Desktop, Codex Desktop 또는 Codex CLI입니다. 배포 ZIP에는 자체 포함 네이티브 런처와 번들 MCP가 들어 있어 별도 Node.js 설치가 필요하지 않습니다.

1. 최신 릴리스에서 premiere-pro-full-mcp-v0.2.0-windows.zip과 .sha256을 내려받아 해시를 확인하고 압축을 풉니다.

2. Premiere Pro를 종료하고 압축을 푼 폴더에서 다음 명령을 실행합니다.

   powershell -NoProfile -ExecutionPolicy Bypass -File .\Install.ps1

3. Creative Cloud Desktop에서 독립 플러그인 설치 경고를 승인합니다. Premiere를 재시작한 뒤 창 > UXP 플러그인 > Premiere Pro Full MCP를 엽니다.

4. 첫 실행 때 **Pair with installed helper…**를 누르고 %LOCALAPPDATA%\PremiereMCP\app\runtime-bootstrap.json을 선택합니다. CCX에는 세션 토큰이 포함되지 않습니다.

5. Codex를 재시작합니다. 연결되지 않으면 다음 Doctor를 실행합니다.

   powershell -NoProfile -ExecutionPolicy Bypass -File "$env:LOCALAPPDATA\PremiereMCP\app\tools\Doctor.ps1" -CheckLive

설치기는 패키지 전 파일의 해시를 검증하고 현재 사용자 영역만 변경하며, 기존 설치와 Codex 설정을 실패 시 복원합니다. CCX 설치를 나중에 하려면 -SkipCcxLaunch, Codex 등록을 생략하려면 -SkipCodexRegistration을 사용합니다.

CEP 호환 브리지는 Adobe ZXP 방식으로 별도 서명되어 있으며, 설치기는 CEP 개발자 모드를 활성화하지 않습니다. EXE와 PowerShell 스크립트에는 Authenticode 서명이 없으므로 게시된 SHA-256과 RSA 릴리스 서명을 확인해야 합니다.

보안 및 지원 범위

이 프로젝트는 “Premiere의 모든 기능이 모든 상황에서 무조건 성공한다”고 주장하지 않습니다. 공개 API 표면 전체를 목록화하고, 라이브 검증된 경로만 지원으로 표시하며, 프로젝트 상태·미디어·플러그인·로그인·권한이 필요한 경로는 명확하게 실패하거나 보류합니다. UXP·CEP·QE·UI 자동화의 검증 범위는 각각 분리해 보고합니다.

취약점은 공개 이슈가 아니라 저장소 Security > Report a vulnerability에서 비공개로 신고해 주세요. 토큰, 실제 프로젝트, 사용자 경로, 미디어 이름은 이슈나 로그에 첨부하지 마세요.

Support

Wenn Premiere Pro Full MCP Ihnen Zeit spart, können Sie die weitere Entwicklung, Host-Versionstests und Sicherheitswartung auf Ko-fi unterstützen.

MIT-Lizenz. Copyright (c) 2026 muhwagwa0112.