Premiere Pro Full MCP v0.2.0

English · 한국어

Premiere Pro Full MCP — это локальный MCP-сервер для Adobe Premiere Pro 2026 в Windows с ограничением возможностей (capability-gated). Он объединяет документированный API Premiere UXP, ограниченный мост CEP/ExtendScript, экспериментальное обнаружение QE и fail-closed агент для нативного интерфейса Windows.

Это неофициальный проект сообщества, не связан с Adobe Inc. и не одобрен ею. «Full» означает, что поддерживаемая поверхность API инвентаризирована и маршрутизирована; это не значит, что каждый элемент интерфейса можно автоматизировать в любом состоянии хоста.

English

Быстрый старт для 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, откройте PowerShell в распакованной папке premiere-pro-full-mcp-0.2.0 и выполните:

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

Установщик проверяет каждый файл пакета, устанавливает только в профиль текущего пользователя, регистрирует premiere_pro_full_mcp в Codex и открывает прилагаемый CCX. 3. Подтвердите предупреждение о независимом плагине в Creative Cloud Desktop. Перезапустите Premiere, затем откройте Окно > UXP-плагины > Premiere Pro Full MCP. 4. При первом использовании нажмите Pair with installed helper… и выберите %LOCALAPPDATA%\PremiereMCP\app\runtime-bootstrap.json. UXP запоминает только разрешение на файл; токен сеанса не хранится в CCX. 5. Перезапустите 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"

Обновления с несоответствиями подписи, репозитория, тега, имени, размера, контрольной суммы, статуса prerelease или понижения версии отклоняются. Удалите CCX отдельно: Creative Cloud Desktop > Plugins > Manage Plugins.

Правила безопасности и ограничений

• Документированный UXP предпочтителен. CEP компенсирует типизированные пробелы совместимости, QE экспериментален, агент Windows UI Automation — последнее средство.

• Неудачные изменения никогда не повторяются автоматически через другой бэкенд.

• Экспорт последовательности использует документированный путь кодировщика UXP, но не доверяет Promise хоста, который может остаться в состоянии «ожидания» после рендеринга; успех требует изменённого, непустого выходного файла, который остаётся стабильным при повторных наблюдениях. Существующие результаты отклоняются, если не реализована явно одобренная политика перезаписи.

• Операции R2/R3 используют короткоживущие, ограниченные областью одноразовые идентификаторы одобрения и независимое доверенное диалоговое окно Windows.

• Сырой ExtendScript, произвольные пути QE/объектов, сырые селекторы/клики UI, команды оболочки и извлечение учётных данных не являются публичными операциями MCP.

• Слушатели привязываются к localhost, конверты CEP аутентифицируются через HMAC и брокер DPAPI CurrentUser, а артефакты релизов никогда не содержат материал загрузки рантайма.

• Работа с файловой системой ограничена явно одобренными каноническими корнями и отклоняет выход через reparse-точки.

• Телеметрия не собирается. Логи и реестры исключают запросы, аргументы, результаты, токены, пути проектов, имена медиафайлов и персональные идентификаторы.

Сгенерированная инвентаризация для Adobe 26.3 содержит 69 корней и 761 вызываемый элемент. Итоговая живая базоволна по всей доступной поверхности совпала со всеми 761 ID. Из 312 детерминированных вызовов «только чтение» 281 завершился успешно, а 31 завершился fail-coated, так как требуемый метод, корень или дескриптор сеанса был недоступен. Ещё 151 рискованная запись была только предварительной, а 298 контекстно -зависимых записей были пропущены с явными причинами. См. живую валидацию.

Разработка

Требования: Node.js 20.19+ (Node 24 предпочтителен), .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 и выделенный приватный ключ подписи в %LOCALAPPDATA%\PremiereMCP. Приватный ключ никогда не сохраняется в репозитории и не выгружается в GitHub Actions. См. развёртывание, безопасность и contributor and.

한국어

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에서 비공개로 신고해 주세요. 토큰, 실제 프로젝트, 사용자 경로, 미디어 이름은 이슈나 로그에 첨부하지 마세요.

Поддержка

Если Premiere Pro Full MCP экономит ваше время, вы можете поддержать дальнейшую разработку, тестирование версии хоста и поддержку безопасности на Ko-fi.

MIT License. Copyright (c) 2026 muhwagwa0112.