dcc-mcp-premiere
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.
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_statusinspect_projectlist_sequencesinspect_sequencelist_project_itemslist_selected_clipslist_encoder_presets
Project and timeline authoring:
create_binimport_mediacreate_sequenceinsert_project_itemoverwrite_project_itemcreate_marker
Persistence and export:
save_projectsave_project_asqueue_sequence_exportexport_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_ROOTSfor imported mediaDCC_MCP_PREMIERE_ALLOWED_OUTPUT_ROOTSfor.prprojand exported mediaDCC_MCP_PREMIERE_ALLOWED_PRESET_ROOTSfor.sqpresetand.eprfiles
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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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 logRelease 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 logSecurity 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.
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 logA 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.