MCP Bridge для Adobe Premiere Pro

Управляйте локальными проектами Adobe Premiere Pro через MCP.

284 инструмента, 13 контекстных ресурсов и 10 направляющих подсказок для Codex, Claude Code, Claude Desktop и других MCP-клиентов. CEP отвечает за редактирование; дополнительный помощник UXP читает транскрипты Speech-to-Text из Premiere.

Языки: English | 日本語 | Tiếng Việt | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | ភាសាខ្មែរ

Начните здесь: установите локальный мост, откройте его в Premiere, затем запустите verify_premiere_connection перед редактированием.

Установка | Плагин Codex | Плагин Claude Code | Проверка | Политика конфиденциальности | Условия использования | Безопасность

Установка

Поддерживаемый мост — это входящая в комплект панель CEP. Установите npm-пакет на тот же компьютер, где работают Premiere Pro и ваш MCP-клиент:

npm install -g @compimprove/adobe-premiere-mcp
premiere-pro-mcp --install-cep
premiere-pro-mcp --doctor

--install-cep устанавливает мост CEP, включает необходимый параметр отладки Adobe CEP, подготавливает каталог моста и настраивает поддерживаемые локальные MCP-клиенты. --doctor проверяет сборку сервера, установку CEP, каталог моста, параметр отладки и конфигурацию клиента.

Затем перезапустите Premiere Pro, откройте Window > Extensions > MCP Bridge (CEP), укажите каталог моста, показанный установщиком, и запустите мост.

Требования:

• Node.js 20+

• Adobe Premiere Pro 2020+

• Premiere Pro, MCP-клиент и этот пакет на одном компьютере

Входящий в комплект uxp-plugin — это независимый помощник для транскриптов Premiere 25.6+. Он не заменяет мост редактирования CEP и пока не устанавливается через CLI.

Плагин Codex

Из клона этого репозитория установите плагин Codex, который объединяет конфигурацию MCP и навык редактирования в Premiere:

codex plugin marketplace add .
codex plugin add premiere-pro-mcp@adobe-premiere-pro-mcp

Плагину по-прежнему требуется локальный мост CEP. Запустите premiere-pro-mcp --install-cep, перезапустите Premiere, запустите Window > Extensions > MCP Bridge (CEP), затем попросите Codex выполнить get_capabilities, а затем verify_premiere_connection.

Плагин Claude Code

Из клона этого репозитория:

/plugin marketplace add .
/plugin install premiere-pro-mcp@adobe-premiere-pro-mcp

Установите и запустите мост CEP теми же шагами, что и выше, перед использованием плагина.

Пакет в один клик для Claude Desktop

Каждый выпуск на GitHub включает пакет .mcpb для Claude Desktop. Загрузите соответствующий файл adobe-premiere-pro-mcp-<version>.mcpb и откройте его в Claude Desktop, чтобы установить локальный MCP-сервер. При первом запуске он устанавливает входящий в комплект мост CEP для текущего пользователя.

Перезапустите Premiere Pro, откройте Window > Extensions > MCP Bridge (CEP), укажите каталог моста и запустите мост. Затем спросите Claude:

Выполни verify_premiere_connection. Ничего не меняй.

Пакет MCPB не подписан. Устанавливайте его только из раздела GitHub Releases этого репозитория. Архивы выпусков CEP корректно помечены как неподписанные или самоподписанные; самоподписанный не означает доверенный в Adobe Marketplace.

Конфигурация MCP-клиента

Установщик настраивает Claude Desktop на macOS и Claude Desktop плюс GitHub Copilot в VS Code на Windows. Для другого MCP-клиента настройте его на запуск:

{
  "mcpServers": {
    "premiere-pro": {
      "command": "premiere-pro-mcp"
    }
  }
}

Установка из исходников

Используйте установку из исходников при разработке MCP, изменении панели CEP или устранении неполадок установки пакета:

git clone https://github.com/compimprove/adobe-premiere-mcp.git
cd adobe-premiere-mcp
npm install
npm run build
npm run setup:mac # macOS

В Windows используйте npm run setup:win из PowerShell после npm install и npm run build.

Текущий интерфейс панели CEP внутри Premiere Pro с обновлёнными элементами управления моста и индикатором состояния.

Related MCP server: Premiere Pro MCP Server

Текущий статус

Этот репозиторий в настоящее время проверен для:

• macOS

• проверок установщика Windows и конфигурации через GitHub Actions

• Adobe Premiere Pro 2020+ (активно используется и тестируется на Premiere Pro 26.0)

• Node.js 20+

• транспорта MCP v2-сервера с современным обнаружением протокола без сохранения состояния

• входящего в комплект пути установщика macOS для Claude Desktop

• входящего в комплект пути установщика Windows для GitHub Copilot в VS Code и конфигурации Claude Desktop

• ручной регистрации MCP для Codex, Claude Code и аналогичных MCP-клиентов

Текущий статус каталога по состоянию на 5 августа 2026 года:

• 284 инструмента MCP доступны для редактирования видео с помощью ИИ

• охват включает настройку проекта, импорт медиа, бины, последовательности, редактирование таймлайна, переходы, эффекты, ключевые кадры, субтитры, маркеры, метаданные, прокси, мультикамеру, цвет, аудио, экспорт и высокоуровневые рабочие процессы сборки

• каталог включает практические агентские рабочие процессы, такие как сборка продуктового ролика, демо-ролики моушн-графики, разрезание таймлайна, чтение субтитров, дакинг аудио, обнаружение сцен, импорт EDL, проверка готовности к экспорту и операции со связанными аудио/видео

Последняя завершённая локальная проверка в реальном времени:

• доступно 284 активных инструмента; get_capabilities сообщает о локальной установке и необязательном состоянии живого подключения, а verify_premiere_connection — это каноническая проверка готовности моста и хоста только для чтения

• 0 известных приостановленных или заглушечных инструментов не рекламируется

• import_ae_comps намеренно не рекламируется, потому что Premiere вернул false для реальных файлов .aep в этом окружении, а универсальный импорт .aep может заблокировать мост CEP

Полный вывод проверки в реальном времени записывается в /tmp/premiere-mcp-bridge/live-tool-sweep.json, когда вы запускаете проверку.

Что вы получаете

Сервер охватывает операции с проектом, импорт, создание последовательностей, редактирование таймлайна, переходы, эффекты, ключевые кадры, метаданные, экспорт и высокоуровневые рабочие процессы сборки.

Примеры подсказок:

• «Перечисли все последовательности и покажи, какая из них активна».

• «Импортируй эти три кадра и собери черновой продуктовый ролик».

• «Добавь перекрёстные растворения на каждый разрез на видеодорожке 1».

• «Примени размытие по Гауссу к среднему клипу».

• «Примени эффект Black & White к активному короткому клипу».

• «Разрежь интервью-последовательность на 12,5 секунды по всем аудио- и видеодорожкам».

• «Экспортируй активную последовательность как FCP XML».

Для монохромных образов предпочитайте apply_effect с Black & White вместо попыток принудительно сделать чёрно-белое через общие настройки только насыщенности.

Перед редактированием вы также можете подключить ресурс premiere://config/get_instructions, чтобы дать модели руководство по работе с Premiere.

Для предсказуемого начала каждой сессии сначала запустите verify_premiere_connection. Он подтверждает, что мост CEP ответил, и возвращает сборку Premiere, открытый проект и активную последовательность, не изменяя проект.

Включённые высокоуровневые инструменты рабочих процессов:

• build_motion_graphics_demo

• assemble_product_spot

• build_brand_spot_from_mogrt_and_assets

assemble_product_spot и build_brand_spot_from_mogrt_and_assets теперь поддерживают необязательный аргумент clipPlan, чтобы LLM мог управлять таймингом каждого клипа, размещением на дорожках, переходами, движением, обрезками, эффектами и цветокоррекцией вместо фиксированных шаблонных значений по умолчанию.

Навык агента

Если вы хотите, чтобы Codex, Claude Code или другой агент правильно выполнял установку, проверку и повседневное использование, установите входящий в комплект навык агента:

npx skills add compimprove/adobe-premiere-mcp --skill premiere-pro-mcp

Или установите напрямую из пути навыка:

npx skills add https://github.com/compimprove/adobe-premiere-mcp/tree/main/skills/premiere-pro-mcp

Навык обучает агентов устанавливать MCP, запускать и проверять мост CEP, безопасно использовать инструменты Premiere, импортировать реальные медиа перед редактированием, предпочитать операции с учётом последовательности и запускать диагностику при сбоях.

Расширенная настройка и проверка

Для установки из исходников, конфигурации MCP для конкретных клиентов, флагов установщика Windows, диагностики и проверки инструментов в реальном времени используйте QUICKSTART.md. Это каноническое руководство по настройке, и оно позволяет этой странице сосредоточиться на выборе и использовании продукта.

Краткая версия:

1. Установите с помощью npm install -g @compimprove/adobe-premiere-mcp, затем запустите premiere-pro-mcp --install-cep.

2. Перезапустите Premiere Pro и ваш MCP-клиент, затем запустите Window > Extensions > MCP Bridge (CEP).

3. Запустите premiere-pro-mcp --doctor, затем попросите клиент вызвать verify_premiere_connection без изменений.

Для ручной регистрации в любом MCP-клиенте используйте глобальную команду после установки npm:

{
  "mcpServers": {
    "premiere-pro": {
      "command": "premiere-pro-mcp"
    }
  }
}

CEP остаётся мостом редактирования. Если Premiere не отображает расширение, включите UXP Plugins > Enable developer mode в настройках Premiere, перезапустите Premiere и снова откройте панель CEP. Отдельная панель UXP требуется только для чтения транскриптов Speech-to-Text.

Для проверки на реальном хосте используйте одноразовый проект Premiere и запустите node scripts/live-tool-sweep.mjs; он создаёт временные последовательности Sweep ... в текущем проекте.

Для установки из исходников, которая включает необязательный мост транскриптов, настройка также:

• устанавливает зависимости

• собирает dist/index.js

• включает режим отладки Adobe CEP

• устанавливает расширение MCP Bridge (CEP)

• создаёт /tmp/premiere-mcp-bridge

• подготавливает очередь команд транскриптов UXP

• добавляет запись MCP premiere-pro в Claude Desktop

Важно:

• MCP Bridge (CEP) остаётся поддерживаемым мостом для существующих инструментов редактирования

• MCP Transcript Bridge (UXP) — это необязательный помощник, используемый только read_sequence_transcription

• установщик автоматически включает режим отладки Adobe CEP

• если Premiere не отображает расширение корректно на вашем компьютере, включите UXP Plugins > Enable developer mode в настройках Premiere Pro перед открытием панели моста

• npm run setup:mac — самый простой путь для Claude Desktop на macOS, потому что он автоматически обновляет конфигурацию Claude Desktop

После завершения установки:

1. Закройте и снова откройте ваш MCP-клиент, если он читает конфигурацию при запуске. Если вы использовали установщик, это означает Claude Desktop.

2. Закройте и снова откройте Premiere Pro.

3. В Premiere Pro на macOS откройте Premiere Pro > Preferences > Plugins и включите UXP Plugins > Enable developer mode.

4. Перезапустите Premiere Pro, если настройка была изменена.

5. Откройте Window > Extensions > MCP Bridge (CEP).

6. Установите Temp Directory в /tmp/premiere-mcp-bridge.

7. Нажмите Save Configuration.

8. Нажмите Start Bridge.

9. Чтобы включить чтение транскриптов, загрузите папку uxp-plugin репозитория в Adobe UXP Developer Tool, затем откройте Window > UXP Plugins > MCP Transcript Bridge.

10. В панели UXP введите /tmp/premiere-mcp-bridge как корень моста, нажмите Save bridge root, затем нажмите Start Bridge.

11. Подключитесь из Codex, Claude Code, Claude Desktop или другого MCP-клиента, используя тот же временный каталог.

12. Если команды CEP не работают, нажмите Run Diagnostics и отправьте обратно /tmp/premiere-mcp-bridge/premiere-mcp-diagnostics-latest.json.

Если вам нужен визуальный ориентир для переключателя режима разработчика, он выглядит так:

Если панель сообщает, что Premiere готов после Start Bridge, мост работает.

Установка по клиенту

Claude Desktop

На macOS используйте:

npm run setup:mac

Это единственный путь в этом репозитории, который автоматически записывает запись MCP за вас.

Codex

Сначала соберите сервер:

npm install
npm run build

Затем добавьте MCP-сервер в одну строку:

codex mcp add premiere_pro --env PREMIERE_TEMP_DIR=/tmp/premiere-mcp-bridge -- node /absolute/path/to/Adobe_Premiere_Pro_MCP/dist/index.js

Claude Code

Соберите сервер так же:

npm install
npm run build

Затем зарегистрируйте MCP-сервер в Claude Code, используя ту же собранную точку входа dist/index.js и ту же временную директорию:

command: node /absolute/path/to/Adobe_Premiere_Pro_MCP/dist/index.js
env: PREMIERE_TEMP_DIR=/tmp/premiere-mcp-bridge

Если вы используете локальный файл конфигурации MCP вместо вспомогательной команды, укажите в нём тот же dist/index.js и задайте ту же переменную окружения.

Другие MCP-клиенты

Используйте тот же подход ручной регистрации, что и в Claude Code:

command: node /absolute/path/to/Adobe_Premiere_Pro_MCP/dist/index.js
env: PREMIERE_TEMP_DIR=/tmp/premiere-mcp-bridge

Важно для всех ручных настроек клиента:

• оставьте команду в одну строку

• используйте реальный абсолютный путь к dist/index.js

• перезапустите клиент после добавления или обновления записи MCP

• запустите мост CEP внутри Premiere и убедитесь, что временная директория — ровно /tmp/premiere-mcp-bridge

• для read_sequence_transcription также запустите UXP Transcript Bridge с той же корневой папкой

Проверка установки

Запустите встроенные проверки:

npm run setup:doctor

Это проверяет:

• версию Node.js

• собранный вывод сервера

• установку расширения CEP

• /tmp/premiere-mcp-bridge

• режим отладки Adobe CEP

• запись конфигурации Claude Desktop при использовании пути установщика

• диагностику панели CEP, записываемую в /tmp/premiere-mcp-bridge/premiere-mcp-diagnostics-latest.json

• heartbeat вспомогательного модуля UXP transcript-helper в /tmp/premiere-mcp-bridge/uxp/status.json, когда работает опциональный вспомогательный модуль

Для более глубокой сквозной проверки используйте одноразовый проект Premiere и выполните:

node scripts/live-tool-sweep.mjs

Это создаёт временные последовательности Sweep ... в текущем открытом проекте, чтобы инструментарий был проверен на реальных данных.

Как работает мост

+-----------+        +-----------+        +-----------+
|  Client   |  MCP   | Node.js   | Files  | CEP Panel |
| (Codex+)  |<------>| MCP Server|<------>| edits     |
+-----------+        +-----------+        +-----------+
                                  |
                                  | Files: uxp/commands + uxp/responses
                                  v
                           +-----------+
                           | UXP panel |
                           | transcripts|
                           +-----------+

1. Клиент вызывает инструмент MCP.

2. Существующие инструменты редактирования генерируют ExtendScript и используют файлы команд панели CEP.

3. read_sequence_transcription записывает версионированный запрос UXP в uxp/commands.

4. Панель UXP читает транскрипции Speech-to-Text исходных клипов через UXP API Premiere и записывает нормализованный ответ в uxp/responses.

5. Сервер возвращает структурированный JSON клиенту MCP. CEP и UXP не вызывают друг друга.

Инструменты

Все 284 заявленных инструмента имеют реализацию. Схемы инструментов доступны через обнаружение MCP; этот каталог объясняет поверхность редактирования человеческим языком. Начните с verify_premiere_connection, затем изучите проект, прежде чем просить агента изменять его.

Обнаружение и проверка проекта

Каталог охватывает:

• Обнаружение и проверку проекта

• Управление проектом и последовательностями

• Импорт медиа и управление бинами

• Размещение на таймлайне и операции с клипами

• Эффекты, переходы, цвет и ключевые кадры

• Маркеры, метаданные, метки и управление рабочей областью

• Экспорт и вспомогательные функции обмена

• MOGRT, субтитры, прокси и вспомогательные функции перелинковки

• Чтение транскрипций Speech-to-Text (Premiere 25.6+ с опциональным вспомогательным модулем UXP)

• Высокоуровневые рабочие процессы сборки рекламы / промо

Проекты, медиа и бины

Последовательности и дорожки

Редактирование таймлайна и операции тримминга

Эффекты, цвет, движение и ключевые кадры

Аудио, переходы и субтитры

Маркеры, выделение, навигация и воспроизведение

Доставка, обмен и управление медиа

Графика, рабочие процессы, рабочее пространство и расширенные операции

Дополнительные поддерживаемые операции

Оставшийся каталог охватывает низкоуровневое управление свойствами медиа, настройками проекта, форматами отображения, сглаживанием, постерами, цветовыми метками, выделением, таргетингом дорожек, путями проекта и количеством проектов. Он включает set_override_frame_rate, set_override_pixel_aspect_ratio, set_frame_blend, set_time_interpolation, set_poster_frame, set_anti_alias_quality, set_uniform_scale, set_scale_width_height, set_sequence_display_format, set_project_scratch_disk, get_project_scratch_disks, get_all_project_paths, get_total_clip_count, get_insertion_bin, is_work_area_enabled и match_frame.

Используйте MCP-интроспекцию в вашем клиенте для получения точной схемы входных данных и формы возвращаемых значений каждого инструмента. Агент должен сначала провести интроспекцию, выполнить точечное изменение и считать затронутое состояние перед продолжением многошагового редактирования.

Реальные ограничения

• Самоподписанный CEP .zxp подтверждает целостность архива, но не является одобрением Adobe Marketplace или гарантией публичного доверия. Воспроизводимый рабочий процесс подписи требует приватных секретов сертификата и проверки Premiere на целевой платформе.

Этот проект гораздо более удобен в использовании, чем исходный прототип, но он не является магией.

• Скриптинг Premiere по-прежнему не предоставляет прямого доступа ко всем операциям UI.

• Дорожки субтитров — это не то же самое, что транскрипты Speech-to-Text: read_sequence_captions по-прежнему недоступен через CEP, тогда как read_sequence_transcription читает транскрипты исходных клипов через UXP.

• Профессиональный дизайн титров по-прежнему зависит от реальных MOGRT-активов или внешних графических рабочих процессов.

• get_render_queue_status полезен только при наличии интеграции с Adobe Media Encoder.

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

Устранение неполадок

Если инструменты видны, но вызовы завершаются ошибкой:

1. Убедитесь, что Premiere Pro открыт и в нём загружен проект.

2. Откройте Window > Extensions > MCP Bridge (CEP).

3. Убедитесь, что временная папка — именно /tmp/premiere-mcp-bridge.

4. Нажмите Start Bridge.

5. Если вы обновили код моста, щёлкните правой кнопкой мыши по панели и выберите Reload.

6. Повторите команду.

Если read_sequence_transcription сообщает, что мост UXP недоступен:

1. Используйте Premiere Pro 25.6 или новее.

2. Включите Plugins > Enable Developer Mode, затем загрузите uxp-plugin с помощью Adobe UXP Developer Tool.

3. Откройте Window > UXP Plugins > MCP Transcript Bridge.

4. Введите /tmp/premiere-mcp-bridge, нажмите Save bridge root, затем нажмите Start Bridge.

5. Убедитесь, что исходные клипы в последовательности были расшифрованы на панели Text в Premiere. Инструмент возвращает частичный результат, если у некоторых исходных клипов нет расшифровки.

Если MCP-клиент не может найти сервер:

1. Проверьте абсолютный путь к dist/index.js.

2. Убедитесь, что PREMIERE_TEMP_DIR=/tmp/premiere-mcp-bridge.

3. Перезапустите MCP-клиент после изменения конфигурации.

4. Выполните npm run setup:doctor.

Заметки для разработчиков

Полезные команды:

npm run build
npm test -- --runInBand
npm run setup:doctor
node scripts/live-tool-sweep.mjs

См.:

• QUICKSTART.md — самый короткий путь установки

• KNOWN_ISSUES.md — текущие ограничения

• CONTRIBUTING.md — процесс разработки