Servidor MCP para Adobe Premiere Pro

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

Controla Adobe Premiere Pro a través de MCP usando Codex, Claude Code, Claude Desktop o cualquier otro cliente MCP.

¿Quieres algo construido desde cero para agentes de IA? Adobe sigue siendo potente, pero no es "AI-first". Ahora estoy creando Monet, un editor de vídeo diseñado desde el primer día para ser controlado totalmente por agentes de codificación.

Si buscas el camino nativo para IA, usa Monet. Si necesitas Adobe Premiere Pro hoy mismo, este proyecto sigue siendo para ti.

Historial de estrellas

Interfaz de usuario del panel CEP actual dentro de Premiere Pro, utilizando los controles del puente renovados y el diseño de estado.

Related MCP server: Premiere Pro MCP Server

Estado actual

Este repositorio está validado actualmente para:

• macOS

• Adobe Premiere Pro 2020+ (usado y probado activamente en Premiere Pro 26.0)

• Node.js 18+

• la ruta del instalador de macOS incluida para Claude Desktop

• registro manual de MCP para Codex, Claude Code y clientes MCP similares

Validación local actual a fecha de 4 de marzo de 2026:

• 97 herramientas expuestas

• 43 herramientas ejecutadas en vivo contra una sesión real de Premiere

• 50 herramientas validadas por esquema en el mismo barrido

• 3 herramientas destructivas sin argumentos fueron omitidas intencionalmente (save_project, undo, consolidate_duplicates)

• 1 limitación de tiempo de ejecución en vivo permanece: get_render_queue_status requiere integración con Adobe Media Encoder

La salida completa del barrido en vivo se escribe en /tmp/premiere-mcp-bridge/live-tool-sweep.json cuando ejecutas el verificador.

Qué obtienes

El servidor cubre operaciones de proyecto, ingesta, creación de secuencias, edición de línea de tiempo, transiciones, efectos, fotogramas clave, metadatos, exportaciones y flujos de trabajo de ensamblaje de alto nivel.

Ejemplos de prompts:

• "Enumera todas las secuencias y muéstrame cuál está activa."

• "Importa estos tres planos y construye un spot de producto preliminar."

• "Añade disolvencias cruzadas a cada corte en la pista de vídeo 1."

• "Aplica Desenfoque Gaussiano al clip central."

• "Aplica el efecto Black & White al clip de formato corto activo."

• "Corta la secuencia de la entrevista en el segundo 12.5 en todas las pistas de audio y vídeo."

• "Exporta la secuencia activa como FCP XML."

Para estilos monocromáticos, prefiere apply_effect con Black & White en lugar de intentar forzar el blanco y negro mediante ajustes genéricos de saturación.

Antes de editar, también puedes adjuntar el recurso premiere://config/get_instructions para dar al modelo una guía operativa específica de Premiere.

Herramientas de flujo de trabajo de alto nivel incluidas:

• build_motion_graphics_demo

• assemble_product_spot

• build_brand_spot_from_mogrt_and_assets

assemble_product_spot y build_brand_spot_from_mogrt_and_assets ahora admiten un argumento opcional clipPlan para que un LLM pueda dirigir la temporización por clip, la colocación en pista, las transiciones, el movimiento, los recortes, los efectos y los ajustes de color en lugar de depender de valores predeterminados de plantilla fijos.

Instalación más rápida (macOS)

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

Ese instalador hará lo siguiente:

• instalar dependencias

• compilar dist/index.js

• habilitar el modo de depuración de Adobe CEP

• instalar la extensión MCP Bridge (CEP)

• crear /tmp/premiere-mcp-bridge

• añadir la entrada MCP premiere-pro a Claude Desktop

Importante:

• el puente de interfaz de usuario compatible en este repositorio es la extensión MCP Bridge (CEP)

• el instalador habilita automáticamente el modo de depuración de Adobe CEP

• si Premiere no expone la extensión correctamente en tu máquina, habilita UXP Plugins > Enable developer mode en las preferencias de Premiere Pro antes de abrir el panel del puente

• npm run setup:mac es la ruta más sencilla para Claude Desktop en macOS porque actualiza la configuración de Claude Desktop automáticamente

Después de que el instalador termine:

1. Cierra y vuelve a abrir tu cliente MCP si lee la configuración al iniciarse. Si usaste el instalador, eso significa Claude Desktop.

2. Cierra y vuelve a abrir Premiere Pro.

3. En Premiere Pro en macOS, abre Premiere Pro > Preferences > Plugins y habilita UXP Plugins > Enable developer mode.

4. Reinicia Premiere Pro si se cambió la configuración.

5. Abre Window > Extensions > MCP Bridge (CEP).

6. Establece Temp Directory en /tmp/premiere-mcp-bridge.

7. Haz clic en Save Configuration.

8. Haz clic en Start Bridge.

9. Conéctate desde Codex, Claude Code, Claude Desktop u otro cliente MCP usando el mismo directorio temporal.

10. Si los comandos fallan, haz clic en Run Diagnostics y envía /tmp/premiere-mcp-bridge/premiere-mcp-diagnostics-latest.json.

Si necesitas una referencia visual para el interruptor del modo de desarrollador, se ve así:

Si el panel informa que Premiere está listo después de Start Bridge, el puente está activo.

Instalación por cliente

Claude Desktop

En macOS, usa:

npm run setup:mac

Esa es la única ruta en este repositorio que escribe automáticamente la entrada MCP por ti.

Codex

Compila el servidor primero:

npm install
npm run build

Luego añade el servidor MCP en una sola línea:

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

Compila el servidor de la misma manera:

npm install
npm run build

Luego registra el servidor MCP en Claude Code usando el mismo punto de entrada dist/index.js compilado y el mismo directorio temporal:

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

Si usas un archivo de configuración MCP local en lugar de un comando auxiliar, apúntalo al mismo dist/index.js y establece la misma variable de entorno.

Otros clientes MCP

Usa el mismo enfoque de registro manual que Claude Code:

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

Importante para todas las configuraciones manuales de cliente:

• mantén el comando en una sola línea

• usa la ruta absoluta real a dist/index.js

• reinicia el cliente después de añadir o actualizar la entrada MCP

• inicia el puente CEP dentro de Premiere y confirma que el directorio temporal es exactamente /tmp/premiere-mcp-bridge

Verificar la instalación

Ejecuta las comprobaciones integradas:

npm run setup:doctor

Esto valida:

• la versión de Node.js

• la salida del servidor compilado

• la instalación de la extensión CEP

• /tmp/premiere-mcp-bridge

• el modo de depuración de Adobe CEP

• la entrada de configuración de Claude Desktop cuando usas la ruta del instalador

• los diagnósticos del panel CEP escritos en /tmp/premiere-mcp-bridge/premiere-mcp-diagnostics-latest.json

Para una comprobación integral más profunda, usa un proyecto de Premiere desechable y ejecuta:

node scripts/live-tool-sweep.mjs

Esto crea secuencias temporales Sweep ... en el proyecto abierto actualmente para que la cadena de herramientas se pruebe con datos reales.

Cómo funciona el puente

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

1. El cliente llama a una herramienta MCP.

2. El servidor Node genera ExtendScript más ayudantes compartidos.

3. El script se escribe en /tmp/premiere-mcp-bridge.

4. El panel CEP sondea ese directorio y ejecuta el script a través de CSInterface.evalScript().

5. El panel escribe el resultado de vuelta en el archivo de respuesta.

6. El servidor devuelve JSON estructurado al cliente MCP.

Cobertura de herramientas

Las 97 herramientas expuestas se agrupan aproximadamente así:

• Descubrimiento e inspección de proyectos

• Gestión de proyectos y secuencias

• Importación de medios y gestión de contenedores (bins)

• Colocación en línea de tiempo y operaciones de clip

• Efectos, transiciones, color y fotogramas clave

• Marcadores, metadatos, etiquetas y control del área de trabajo

• Ayudantes de exportación e intercambio

• MOGRT, subtítulos, proxies y ayudantes de revinculación

• Flujos de trabajo de ensamblaje de anuncios / promociones de alto nivel

Usa la introspección MCP en tu cliente para ver el catálogo completo de herramientas y los esquemas exactos.

Límites reales

Este proyecto es mucho más utilizable que el prototipo original, pero no es magia.

• El scripting de Premiere todavía no expone todas las operaciones de la interfaz de usuario de forma limpia.

• El diseño de títulos profesional todavía depende de activos MOGRT reales o flujos de trabajo gráficos externos.

• get_render_queue_status solo es útil cuando la integración con Adobe Media Encoder está disponible.

• Los mejores resultados provienen de metraje fuente real, audio real y activos de marca reales. La capa de automatización los ensambla y manipula; no reemplaza el criterio editorial.

Solución de problemas

Si las herramientas son visibles pero las llamadas fallan:

1. Confirma que Premiere Pro está abierto con un proyecto cargado.

2. Abre Window > Extensions > MCP Bridge (CEP).

3. Confirma que el directorio temporal es exactamente /tmp/premiere-mcp-bridge.

4. Haz clic en Start Bridge.

5. Si actualizaste el código del puente, haz clic derecho en el panel y elige Reload.

6. Reintenta el comando.

Si el cliente MCP no puede encontrar el servidor:

1. Verifica la ruta absoluta a dist/index.js.

2. Verifica PREMIERE_TEMP_DIR=/tmp/premiere-mcp-bridge.

3. Reinicia el cliente MCP después de cambiar la configuración.

4. Ejecuta npm run setup:doctor.

Notas para desarrolladores

Comandos útiles:

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

Ver:

• QUICKSTART.md para la ruta de instalación más corta

• KNOWN_ISSUES.md para los límites actuales

• CONTRIBUTING.md para el flujo de trabajo de desarrollo