MCP-сервер для Adobe Premiere Pro

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

Управляйте Adobe Premiere Pro через MCP с помощью Codex, Claude Code, Claude Desktop или любого другого MCP-клиента.

Хотите решение, изначально созданное для ИИ-агентов? Adobe по-прежнему мощный инструмент, но он не ориентирован на ИИ в первую очередь. Сейчас я создаю Monet — видеоредактор, ориентированный на ИИ, разработанный для полного управления кодирующими агентами с первого дня.

Если вам нужен путь, ориентированный на ИИ, используйте Monet. Если вам нужен Adobe Premiere Pro сегодня, этот проект по-прежнему для вас.

История звезд

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

Related MCP server: Premiere Pro MCP Server

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

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

• macOS

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

• Node.js 18+

• включенного пути установки для macOS для Claude Desktop

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

Текущая локальная проверка на 4 марта 2026 года:

• 97 инструментов доступны

• 43 инструмента были выполнены в реальной сессии Premiere

• 50 инструментов прошли проверку схемы в том же проходе

• 3 деструктивных инструмента без аргументов были намеренно пропущены (save_project, undo, consolidate_duplicates)

• 1 ограничение времени выполнения остается: get_render_queue_status требует интеграции с Adobe Media Encoder

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

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

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

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

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

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

• "Добавь перекрестное растворение к каждой склейке на видеодорожке 1."

• "Примени Gaussian Blur к среднему клипу."

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

• "Разрежь последовательность интервью на 12.5 секундах на всех аудио- и видеодорожках."

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

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

Перед началом монтажа вы также можете подключить ресурс premiere://config/get_instructions, чтобы дать модели специфические инструкции по работе с 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 могла управлять таймингом каждого клипа, размещением на дорожке, переходами, движением, обрезкой, эффектами и цветокоррекцией вместо использования фиксированных шаблонов по умолчанию.

Самая быстрая установка (macOS)

git clone https://github.com/hetpatel-11/Adobe_Premiere_Pro_MCP.git
cd Adobe_Premiere_Pro_MCP
npm run setup:mac

Этот установщик:

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

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

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

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

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

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

Важно:

• поддерживаемый мост пользовательского интерфейса в этом репозитории — это расширение MCP Bridge (CEP)

• установщик автоматически включает режим отладки 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. Подключитесь из Codex, Claude Code, Claude Desktop или другого MCP-клиента, используя ту же временную директорию.

10. Если команды не выполняются, нажмите 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

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

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

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

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

node scripts/live-tool-sweep.mjs

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

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

+-----------+        +-----------+        +-----------+
|  Client   |  MCP   | Node.js   | Files  | CEP Panel |
| (Codex+)  |<------>| MCP Server|<------>| (Premiere)|
+-----------+        +-----------+        +-----------+
                                                 |
                                                 v
                                          +-----------+
                                          | Premiere  |
                                          | DOM / QE  |
                                          +-----------+

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

2. Node-сервер генерирует ExtendScript плюс общие вспомогательные функции.

3. Скрипт записывается в /tmp/premiere-mcp-bridge.

4. Панель CEP опрашивает эту директорию и запускает скрипт через CSInterface.evalScript().

5. Панель записывает результат обратно в файл ответа.

6. Сервер возвращает структурированный JSON клиенту MCP.

Охват инструментов

97 доступных инструментов сгруппированы примерно так:

• Обнаружение и инспекция проекта

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

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

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

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

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

• Помощники по экспорту и обмену

• MOGRT, субтитры, прокси и помощники по перелинковке

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

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

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

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

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

• Профессиональный дизайн титров по-прежнему зависит от реальных активов 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. Повторите команду.

Если 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 для рабочего процесса разработки