Skip to main content

dcc-mcp-premiere

DCC-MCP · PREMIERE PRO

Typed DCC-MCP control for Adobe Premiere Pro through the shared adobepy broker and Adobe's UXP runtime. The adapter exposes bounded project, media, timeline, marker, save, frame-export, and AME queue operations. It deliberately does not expose raw JavaScript, evalJs, shell commands, or arbitrary UXP calls.

Premiere Pro typed project and timeline workflow

Illustrative workflow generated with OpenAI ImageGen from the retained source in docs/images/sources; it is not a Premiere Pro screenshot or host-validation artifact.

Part of the DCC-MCP host matrix

dcc-mcp-premiere — Adobe Premiere Pro adapter for DCC-MCP.

It is one of 47 host adapters in the DCC-MCP catalog. Every adapter speaks the same MCP protocol and builds on the same core runtime contract; each one exposes the tools its own host needs on top of that.

This block is generated from the catalog entry in dcc-mcp-catalog.yml. Re-run the generator after changing the catalog.

Install

python -m pip install dcc-mcp-premiere
adobepy install-bridge premiere --dest <plugin-dir> --token <non-default-token>

For development or an Internal deployment with an approved prebuilt UXP bridge, the shared CLI can link that bridge into the Adobe debug-plugin directory:

dcc-mcp-cli install --dcc-type premiere `
  --plugin-source F:\studio\artifacts\premiere-uxp-bridge `
  --adobe-debug-root F:\studio\adobe-debug `
  --execute

DCC_MCP_PLUGIN_SOURCE and DCC_MCP_ADOBE_DEBUG_ROOT can be used in a studio profile. The source directory must be the bridge root and contain its manifest.json; the command does not assume that the adapter repository itself contains UXP assets. It creates an idempotent directory link, does not copy the bridge, and does not require UXP Developer Tool. Enable Premiere's UXP debug mode once, then restart Premiere after the link is created. Premiere Pro 25.6 or later is required. Set ADOBEPY_TOKEN to the bridge token, start the adapter, then verify the connected host through DCC-MCP discovery:

dcc-mcp-cli wait-ready --dcc-type premiere --timeout-secs 60
dcc-mcp-cli load-skill premiere-project --dcc-type premiere

UXP Developer Tool remains a fallback for investigating a host-specific load problem.

Each adapter instance uses an OS-assigned port and registers with DCC-MCP discovery. Agents should connect through the stable local gateway at http://127.0.0.1:9765/mcp. Set DCC_MCP_PREMIERE_PORT only for a deliberately fixed direct endpoint.

Typed tools

Inspection:

  • get_status
  • inspect_project
  • list_sequences
  • inspect_sequence
  • list_project_items
  • list_selected_clips
  • list_encoder_presets

Project and timeline authoring:

  • create_bin
  • import_media
  • create_sequence
  • insert_project_item
  • overwrite_project_item
  • create_marker

Persistence and export:

  • save_project
  • save_project_as
  • queue_sequence_export
  • export_frame

List and scan operations are paginated and bounded. Imports accept at most 100 files, with per-file and aggregate byte limits. Track indices, marker text, frame dimensions, and output extensions are validated before invoking the host. AME export reports queued=true; completion must be verified separately.

Safe local paths

The adapter resolves paths before calling Premiere and confines them to:

  • DCC_MCP_PREMIERE_ALLOWED_INPUT_ROOTS for imported media
  • DCC_MCP_PREMIERE_ALLOWED_OUTPUT_ROOTS for .prproj and exported media
  • DCC_MCP_PREMIERE_ALLOWED_PRESET_ROOTS for .sqpreset and .epr files

Each variable uses the platform path separator and defaults to the current user's home directory. Existing outputs require overwrite=true; missing parent directories require create_parents=true. Verified synchronous outputs include byte count and SHA-256.

Real-host acceptance

Automated tests use contract-compatible facade fakes; they are not represented as live Premiere proof. With a disposable project open and the UXP bridge connected, configure the three allowlists and run:

set DCC_MCP_PREMIERE_SMOKE_MEDIA=C:\path\to\media.mp4
set DCC_MCP_PREMIERE_SMOKE_ROOT=C:\path\to\writable-evidence
python tools/live_premiere_smoke.py

The smoke script uses dcc-mcp-cli for readiness, skill loading, and every typed call. It imports media, authors and inspects a sequence, adds a marker, saves a verified project copy, exports a verified frame, and prints hashes. Set DCC_MCP_PREMIERE_SMOKE_EPR to an allowlisted .epr file to include an AME queue test.

Development

python -m pip install -e ".[dev]"
python -m pytest -q
python -m ruff check src tests tools
python -m ruff format --check src tests tools
python tools/lint_skills.py
python -m build
python -m twine check dist/*

See docs/architecture.md for ownership, readiness, and security boundaries.

Metadata

Release files for dcc-mcp-premiere 0.6.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for dcc-mcp-premiere 0.6.3
File Size Uploaded Provenance Actions
dcc_mcp_premiere-0.6.3.tar.gz 57.8 kB With provenance Details for dcc_mcp_premiere-0.6.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for dcc-mcp-premiere 0.6.3
File Interpreter ABI Platform Actions
dcc_mcp_premiere-0.6.3-py3-none-any.whl Python 3 none any Details for dcc_mcp_premiere-0.6.3-py3-none-any.whl

Total release size: 103.2 kB

Release files / dcc_mcp_premiere-0.6.3.tar.gz

Download URL dcc_mcp_premiere-0.6.3.tar.gz
Size 57.8 kB
Tags Source
SHA-256 checksum
How to use checksums
0aea8233a8870b357d881181caa1d9a20afa1bca2a4e0496707ed834bc76ef32
BLAKE2b-256 checksum
How to use checksums
295262969fc3f3120d9337b581b0d4937273461fb0cbf93a42b5128496e09994
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 18, 2026.

Transparency log

Release files / dcc_mcp_premiere-0.6.3-py3-none-any.whl

Download URL dcc_mcp_premiere-0.6.3-py3-none-any.whl
Size 45.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d872850c2c693c5aa423bffca262eaf8d1c2a81b150a3f7532909c91ca54d999
BLAKE2b-256 checksum
How to use checksums
45e421e305116bee10ce6153665528e4fc65fd21bf2e4039a4fa60c31c0e7ae4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 18, 2026.

Transparency log

Security for dcc-mcp-premiere 0.6.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for dcc_mcp_premiere-0.6.3.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 18, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page