# leancoderkavy/premiere-pro-mcp architecture

> Architecture diagram of the GitHub repository leancoderkavy/premiere-pro-mcp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/leancoderkavy/premiere-pro-mcp
- Repository: https://github.com/leancoderkavy/premiere-pro-mcp

## Overview

This is a local-first MCP server that lets compatible AI clients inspect and operate Premiere Pro through structured tools. The principal path is client request → MCP tool dispatch → generated ExtendScript or UXP command → Premiere host → result. Tool families cover project/media organization, timeline editing, effects and export; separate planning, review, context, and guided-workflow capabilities support safer editorial work. The excerpts show the MCP registration and file bridge, while several domain modules are indexed but unsampled; their broader capabilities and links are included only where the README documents them.

Main entry points: [`src/server.ts`](https://github.com/leancoderkavy/premiere-pro-mcp/blob/main/src/server.ts) (MCP server), [`src/bridge/file-bridge.ts`](https://github.com/leancoderkavy/premiere-pro-mcp/blob/main/src/bridge/file-bridge.ts) (CEP file bridge), [`src/tools/review-plans.ts`](https://github.com/leancoderkavy/premiere-pro-mcp/blob/main/src/tools/review-plans.ts) (Editorial planning), [`cep-plugin/main.js`](https://github.com/leancoderkavy/premiere-pro-mcp/blob/main/cep-plugin/main.js) (CEP connector)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["MCP entry"]
  node_server["MCP server<br/>[server.ts]"]
  node_stdio["CLI entry<br/>[index.ts]"]
end

subgraph group_editing["Editing tools"]
  node_project["Project tools<br/>[project.ts]"]
  node_media["Media tools<br/>[media.ts]"]
  node_sequence["Sequence tools<br/>[sequence.ts]"]
  node_timeline["Timeline tools<br/>[timeline.ts]"]
  node_effects["Effects and export"]
  node_other_tools["Editing tool families"]
end

subgraph group_planning["Planning and context"]
  node_review["Editorial planning<br/>[review-plans.ts]"]
  node_review_logic["Review planners"]
  node_context[("Project context")]
  node_resources["MCP resources"]
  node_workflows["Guided workflows"]
end

subgraph group_connectors["Host connectors"]
  node_file_bridge["CEP file bridge<br/>[file-bridge.ts]"]
  node_script_builder["ExtendScript builder<br/>[script-builder.ts]"]
  node_cep["CEP connector<br/>[main.js]"]
  node_uxp_bridge["UXP WebSocket bridge"]
  node_uxp["UXP connector<br/>[index.cjs]"]
end

node_client(("AI assistant"))
node_premiere["Premiere Pro"]

node_client -->|"sends MCP requests"| node_server
node_stdio -->|"starts"| node_server
node_server -->|"registers tools"| node_project
node_server -->|"registers tools"| node_media
node_server -->|"registers tools"| node_sequence
node_server -->|"registers tools"| node_timeline
node_server -->|"registers tools"| node_effects
node_server -->|"registers tools"| node_other_tools
node_server -->|"invokes commands"| node_file_bridge
node_server -.->|"exposes workflows"| node_review
node_review -->|"runs planners"| node_review_logic
node_server -.->|"serves context"| node_context
node_server -.->|"serves resources"| node_resources
node_server -.->|"offers workflows"| node_workflows
node_file_bridge -->|"builds bootstrap"| node_script_builder
node_file_bridge -->|"exchanges command files"| node_cep
node_cep -.->|"runs host scripts"| node_premiere
node_server -.->|"uses UXP transport"| node_uxp_bridge
node_uxp_bridge -.->|"connects WebSocket"| node_uxp
node_uxp -->|"runs host commands"| node_premiere

click node_server "https://github.com/leancoderkavy/premiere-pro-mcp/blob/main/src/server.ts"
click node_stdio "https://github.com/leancoderkavy/premiere-pro-mcp/blob/main/src/index.ts"
click node_project "https://github.com/leancoderkavy/premiere-pro-mcp/blob/main/src/tools/project.ts"
click node_media "https://github.com/leancoderkavy/premiere-pro-mcp/blob/main/src/tools/media.ts"
click node_sequence "https://github.com/leancoderkavy/premiere-pro-mcp/blob/main/src/tools/sequence.ts"
click node_timeline "https://github.com/leancoderkavy/premiere-pro-mcp/blob/main/src/tools/timeline.ts"
click node_effects "https://github.com/leancoderkavy/premiere-pro-mcp/tree/main/src/tools"
click node_other_tools "https://github.com/leancoderkavy/premiere-pro-mcp/tree/main/src/tools"
click node_review "https://github.com/leancoderkavy/premiere-pro-mcp/blob/main/src/tools/review-plans.ts"
click node_review_logic "https://github.com/leancoderkavy/premiere-pro-mcp/tree/main/src/ai"
click node_context "https://github.com/leancoderkavy/premiere-pro-mcp/tree/main/src/context"
click node_resources "https://github.com/leancoderkavy/premiere-pro-mcp/tree/main/src/resources"
click node_workflows "https://github.com/leancoderkavy/premiere-pro-mcp/tree/main/src/workflows"
click node_file_bridge "https://github.com/leancoderkavy/premiere-pro-mcp/blob/main/src/bridge/file-bridge.ts"
click node_script_builder "https://github.com/leancoderkavy/premiere-pro-mcp/blob/main/src/bridge/script-builder.ts"
click node_cep "https://github.com/leancoderkavy/premiere-pro-mcp/blob/main/cep-plugin/main.js"
click node_uxp_bridge "https://github.com/leancoderkavy/premiere-pro-mcp/blob/main/src/bridge/uxp-websocket-bridge.ts"
click node_uxp "https://github.com/leancoderkavy/premiere-pro-mcp/blob/main/uxp-plugin/index.cjs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_server,node_stdio toneBlue
class node_project,node_media,node_sequence,node_timeline,node_effects,node_other_tools toneAmber
class node_review,node_review_logic,node_context,node_resources,node_workflows toneMint
class node_file_bridge,node_script_builder,node_cep,node_uxp_bridge,node_uxp toneRose
class node_client,node_premiere toneIndigo
```

## Components

### MCP entry

- [MCP server](https://github.com/leancoderkavy/premiere-pro-mcp/blob/main/src/server.ts): `src/server.ts`
- [CLI entry](https://github.com/leancoderkavy/premiere-pro-mcp/blob/main/src/index.ts): `src/index.ts`

### Editing tools

- [Project tools](https://github.com/leancoderkavy/premiere-pro-mcp/blob/main/src/tools/project.ts): `src/tools/project.ts`
- [Media tools](https://github.com/leancoderkavy/premiere-pro-mcp/blob/main/src/tools/media.ts): `src/tools/media.ts`
- [Sequence tools](https://github.com/leancoderkavy/premiere-pro-mcp/blob/main/src/tools/sequence.ts): `src/tools/sequence.ts`
- [Timeline tools](https://github.com/leancoderkavy/premiere-pro-mcp/blob/main/src/tools/timeline.ts): `src/tools/timeline.ts`
- [Effects and export](https://github.com/leancoderkavy/premiere-pro-mcp/tree/main/src/tools): `src/tools`
- [Editing tool families](https://github.com/leancoderkavy/premiere-pro-mcp/tree/main/src/tools): `src/tools`

### Planning and context

- [Editorial planning](https://github.com/leancoderkavy/premiere-pro-mcp/blob/main/src/tools/review-plans.ts): `src/tools/review-plans.ts`
- [Review planners](https://github.com/leancoderkavy/premiere-pro-mcp/tree/main/src/ai): `src/ai`
- [Project context](https://github.com/leancoderkavy/premiere-pro-mcp/tree/main/src/context): `src/context`
- [MCP resources](https://github.com/leancoderkavy/premiere-pro-mcp/tree/main/src/resources): `src/resources`
- [Guided workflows](https://github.com/leancoderkavy/premiere-pro-mcp/tree/main/src/workflows): `src/workflows`

### Host connectors

- [CEP file bridge](https://github.com/leancoderkavy/premiere-pro-mcp/blob/main/src/bridge/file-bridge.ts): `src/bridge/file-bridge.ts`
- [ExtendScript builder](https://github.com/leancoderkavy/premiere-pro-mcp/blob/main/src/bridge/script-builder.ts): `src/bridge/script-builder.ts`
- [CEP connector](https://github.com/leancoderkavy/premiere-pro-mcp/blob/main/cep-plugin/main.js): `cep-plugin/main.js`
- [UXP WebSocket bridge](https://github.com/leancoderkavy/premiere-pro-mcp/blob/main/src/bridge/uxp-websocket-bridge.ts): `src/bridge/uxp-websocket-bridge.ts`
- [UXP connector](https://github.com/leancoderkavy/premiere-pro-mcp/blob/main/uxp-plugin/index.cjs): `uxp-plugin/index.cjs`

### Other components

- **AI assistant**
- **Premiere Pro**

## Connections

- AI assistant → MCP server: sends MCP requests (evidence: `README.md`)
- CLI entry → MCP server: starts (evidence: `src/index.ts`)
- MCP server → Project tools: registers tools (evidence: `src/server.ts`)
- MCP server → Media tools: registers tools (evidence: `src/server.ts`)
- MCP server → Sequence tools: registers tools (evidence: `src/server.ts`)
- MCP server → Timeline tools: registers tools (evidence: `src/server.ts`)
- MCP server → Effects and export: registers tools (evidence: `src/server.ts`)
- MCP server → Editing tool families: registers tools (evidence: `src/server.ts`)
- MCP server → CEP file bridge: invokes commands (evidence: `src/server.ts`)
- MCP server → Editorial planning: exposes workflows (evidence: `README.md`)
- Editorial planning → Review planners: runs planners (evidence: `src/tools/review-plans.ts`)
- MCP server → Project context: serves context (evidence: `README.md`)
- MCP server → MCP resources: serves resources (evidence: `README.md`)
- MCP server → Guided workflows: offers workflows (evidence: `README.md`)
- CEP file bridge → ExtendScript builder: builds bootstrap (evidence: `src/bridge/file-bridge.ts`)
- CEP file bridge → CEP connector: exchanges command files (evidence: `src/bridge/file-bridge.ts`)
- CEP connector → Premiere Pro: runs host scripts
- MCP server → UXP WebSocket bridge: uses UXP transport (evidence: `README.md`)
- UXP WebSocket bridge → UXP connector: connects WebSocket (evidence: `README.md`)
- UXP connector → Premiere Pro: runs host commands (evidence: `uxp-plugin/index.cjs`)
