Premiere Pro Full MCP v0.2.0

영어 · 한국어

Premiere Pro Full MCP는 Windows에서 실행되는 Adobe Premiere Pro 2026을 위한 로컬, 기능 제한(capability-gated) MCP 서버입니다. 문서화된 Premiere UXP API, 제한된 CEP/ExtendScript 브리지, 실험적 QE 탐색, 그리고 실패 시 닫히는(fail-closed) 네이티브 Windows UI 에이전트를 결합합니다.

이 프로젝트는 비공식 커뮤니티 프로젝트이며 Adobe Inc.와 제휴하거나 보증하지 않습니다. “Full”은 지원되는 API 표면을 인벤토리화하고 라우팅한다는 의미이지, 모든 UI 기능이 모든 호스트 상태에서 스크립트로 제어될 수 있다는 뜻은 아닙니다.

Windows 빠른 시작

요구 사항: Windows 10/11 x64, Premiere Pro 26.3 이상, Creative Cloud Desktop, Codex Desktop 또는 Codex CLI가 필요합니다. Node.js는 패키징된 런타임에 필요하지 않습니다.

1. 최신 릴리스에서 premiere-pro-full-mcp-v0.2.0-windows.zip을 다운로드합니다. 인접한 .sha256 파일을 확인한 후 압축을 푸세요.

2. Premiere Pro를 닫고 압축을 푼 premiere-pro-full-mcp-0.2.0 폴더에서 PowerShell을 연 다음 다음 명령을 실행합니다:

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

3. 설치기는 패키지된 모든 파일을 검증하고, 현재 사용자 프로필에만 설치하며, Codex에 premiere_pro_full_mcp를 등록하고, 번들된 CCX를 엽니다.

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

5. 첫 사용 시 **Pair with installed helper…**를 클릭하고 %LOCALAPPDATA%\PremiereMCP\app\runtime-bootstrap.json을 선택합니다. UXP는 파일 권한만 기억하며, 세션 토큰은 CCX에 저장되지 않습니다.

6. Codex를 재시작하고 호스트/기능 검사 도구를 호출하세요. 브리지가 연결되지 않았다면 Doctor를 실행하세요:

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

실행 파일과 PowerShell 스크립트는 Authenticode 서명이 없습니다. Windows에서 SmartScreen 경고가 표시될 수 있습니다. 릴리스는 별도의 RSA 서명 업데이트 매니페스트, 정확한 자산 크기/SHA-256 바인딩, 패키지 내부 SHA-256 매니페스트를 사용합니다. 번들된 CEP 호환 브리지는 Adobe ZXP 패키지 서명을 포함하므로 설치 시 CEP 개발자 모드가 활성화되지 않습니다. 초기 다운로드는 GitHub HTTPS와 게시된 체크섬에 의존하므로, 체크섬이나 소스가 예상과 다르다면 경고를 무시하지 마세요.

업데이트 및 제거

# 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"

업데이트는 서명, 저장소, 태그, 이름, 크기, 다이제스트, 사전 릴리스, 다운그레이드 불일치를 거부합니다. CCX는 Creative Cloud Desktop > Plugins > Manage Plugins에서 별도로 제거하세요.

안전 및 기능 계약

• 문서화된 UXP를 우선합니다. CEP는 제한된 타입 호환성 격차를 메우고, QE는 실험적이며, Windows UI 자동화는 마지막 수단입니다.

• 실패한 변경(mutation)은 다른 백엔드를 통해 자동으로 재실행되지 않습니다.

• 시퀀스 내보내기는 문서화된 UXP 인코더 경로를 사용하지만, 렌더링 후 대기 중인 호스트 Promise를 신뢰하지 않습니다. 성공하려면 반복 관찰 사이에 안정적으로 유지되는 비어 있지 않은 변경된 출력 파일이 필요합니다. 명시적으로 승인된 덮어쓰기 정책이 구현되지 않는 한 기존 출력은 거부됩니다.

• R2/R3 작업은 수명이 짧고 범위가 제한된 일회용 승인 ID와 독립적이고 신뢰할 수 있는 Windows 대화 상자를 사용합니다.

• 원시 ExtendScript, 임의의 QE/객체 경로, raw UI 선택자/클릭, 셸 명령, 자격 증명 추출은 공개 MCP 작업으로 가능하지 않습니다.

• 리스너는 localhost에 바인딩되고, CEP 엔벨로프는 DPAPI CurrentUser 브로커를 통해 HMAC 인증되며, 릴리스 아티클에는 런타임 부트스트래핑 자료가 포함되지 않습니다.

• 파일 시스템 작업은 명시적으로 승인된 표준 루트로 제한되며 재구성 지점 탈출(reparse-point escapes)을 거부합니다.

• 어떤 원격 분석도 수집하지 않습니다. 로그와 원장에는 프롬프트, 인수, 결과, 토큰, 프로젝트 경로, 미디어 이름, 개인 식별자가 제외됩니다.

생성된 Adobe 26.3 인벤토리에는 69개의 루트와 761개의 호출 가능한 멤버가 포함됩니다. 최종 라이브 전체 표면 기준은 761개 ID와 모두 일치했습니다. 시도한 312개의 결정적 읽기 전용 호출 중 281건이 성공했고, 필요한 메서드·루트·세션 핸들을 사용할 수 없어 31건이 실패로 종결되었습니다. 다른 151개의 위험 요소 항목은 미리 보기 전용이었고, 298개의 컨텍스트 종속 항목은 명시적인 이유로 건너뛰었습니다. 자세한 내용은 라이브 검증을 참고하세요.

개발

요구 사항: Node.js 20.19+ (Node 24 "N/A"), .NET 8 SDK, Premiere Pro 26.3+, 그리고 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

릴리스 빌드는 깨끗한 Git 근무 트리(worktree)와 %LOCALAPPDATA%\PremiereMCP 아래의 전용 개인 서명 키가 필요합니다. 개인 키는 GitHub Actions에 커밋하거나 업로드하지 않습니다. 배포, 보안, 기여를 참조하세요.

한국어

Windows 빠른 시작

요구 사항은 Windows 10/11 x64, Premiere Pro 26.3 이상, Adobe Premiere Pro, 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에서 비공개로 신고해 주세요. 토큰, 실제 프로젝트, 사용자 경로, 미디어 이름은 문제나 로그에 첨부하지 마세요.

후원

Premiere Pro Full MCP가 시간과 노력을 절약해 준다면, Ko-fi를 통해 지속적인 개발, 호스트-버전 테스트, 보안 유지에 기부할 수 있습니다.

MIT License. Copyright (c) 2026 muhwagwa0112.