Skip to main content
Glama

Adobe Premiere Pro MCP 서버

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

Codex, Claude Code, Claude Desktop 또는 기타 MCP 클라이언트를 사용하여 MCP를 통해 Adobe Premiere Pro를 제어하세요.

AI 에이전트를 위해 처음부터 새로 구축된 것을 원하시나요? Adobe는 여전히 강력하지만 AI 우선(AI-first)은 아닙니다. 저는 현재 처음부터 코딩 에이전트가 완전히 제어할 수 있도록 설계된 AI 우선 비디오 편집기인 Monet을 만들고 있습니다.

AI 네이티브 경로를 원하신다면 Monet을 사용하세요. 오늘 당장 Adobe Premiere Pro가 필요하시다면 이 프로젝트가 적합합니다.

현재 MCP 브리지 (CEP) 패널

Star History

새로워진 브리지 제어 및 상태 레이아웃을 사용하는 Premiere Pro 내부의 현재 CEP 패널 UI입니다.

Related MCP server: Premiere Pro MCP Server

현재 상태

이 저장소는 현재 다음 사항에 대해 검증되었습니다:

  • macOS

  • Adobe Premiere Pro 2020 이상 (Premiere Pro 26.0에서 활발히 사용 및 테스트됨)

  • Node.js 18 이상

  • Claude Desktop을 위한 포함된 macOS 설치 프로그램 경로

  • Codex, Claude Code 및 유사한 MCP 클라이언트를 위한 수동 MCP 등록

2026년 3월 4일 기준 현재 로컬 검증:

  • 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의 모든 컷에 교차 디졸브를 추가해줘."

  • "중간 클립에 가우시안 흐림 효과를 적용해줘."

  • "활성화된 짧은 형식 클립에 Black & White 효과를 적용해줘."

  • "인터뷰 시퀀스를 12.5초 지점에서 모든 오디오 및 비디오 트랙에 걸쳐 면도날로 잘라줘."

  • "활성화된 시퀀스를 FCP XML로 내보내줘."

흑백 느낌을 원할 경우, 일반적인 채도 전용 조정으로 흑백을 강제하는 대신 Black & White와 함께 apply_effect를 사용하는 것이 좋습니다.

편집하기 전에 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 생성

  • Claude Desktop에 premiere-pro MCP 항목 추가

중요:

  • 이 저장소에서 지원되는 UI 브리지는 MCP Bridge (CEP) 확장 프로그램입니다.

  • 설치 프로그램은 Adobe CEP 디버그 모드를 자동으로 활성화합니다.

  • Premiere가 시스템에서 확장 프로그램을 깔끔하게 노출하지 않는 경우, 브리지 패널을 열기 전에 Premiere Pro 환경 설정에서 UXP 플러그인 > 개발자 모드 활성화를 켜십시오.

  • npm run setup:mac은 Claude Desktop 설정을 자동으로 업데이트하므로 macOS에서 Claude Desktop을 위한 가장 쉬운 경로입니다.

설치 프로그램이 완료된 후:

  1. 시작 시 구성을 읽는 경우 MCP 클라이언트를 종료했다가 다시 엽니다. 설치 프로그램을 사용했다면 Claude Desktop을 의미합니다.

  2. Premiere Pro를 종료했다가 다시 엽니다.

  3. macOS의 Premiere Pro에서 Premiere Pro > 환경 설정 > 플러그인을 열고 UXP 플러그인 > 개발자 모드 활성화를 켭니다.

  4. 설정이 변경된 경우 Premiere Pro를 다시 시작합니다.

  5. 창 > 확장 프로그램 > MCP Bridge (CEP)를 엽니다.

  6. 임시 디렉토리를 /tmp/premiere-mcp-bridge로 설정합니다.

  7. 구성 저장을 클릭합니다.

  8. 브리지 시작을 클릭합니다.

  9. 동일한 임시 디렉토리를 사용하여 Codex, Claude Code, Claude Desktop 또는 다른 MCP 클라이언트에서 연결합니다.

  10. 명령이 실패하면 진단 실행을 클릭하고 /tmp/premiere-mcp-bridge/premiere-mcp-diagnostics-latest.json을 다시 보냅니다.

개발자 모드 토글에 대한 시각적 참조가 필요한 경우 다음과 같습니다:

Premiere Pro에서 UXP 개발자 모드 활성화

브리지 시작 후 패널에서 Premiere가 준비되었다고 보고하면 브리지가 라이브 상태입니다.

클라이언트별 설치

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

그런 다음 동일한 빌드된 dist/index.js 진입점과 동일한 임시 디렉토리를 사용하여 Claude Code에 MCP 서버를 등록하세요:

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 항목을 추가하거나 업데이트한 후 클라이언트를 다시 시작하세요.

  • Premiere 내에서 CEP 브리지를 시작하고 임시 디렉토리가 정확히 /tmp/premiere-mcp-bridge인지 확인하세요.

설치 확인

내장된 검사를 실행하세요:

npm run setup:doctor

다음 사항을 검증합니다:

  • Node.js 버전

  • 빌드된 서버 출력

  • CEP 확장 프로그램 설치

  • /tmp/premiere-mcp-bridge

  • Adobe CEP 디버그 모드

  • 설치 프로그램 경로를 사용할 때의 Claude Desktop 구성 항목

  • /tmp/premiere-mcp-bridge/premiere-mcp-diagnostics-latest.json에 기록된 CEP 패널 진단

더 깊은 엔드 투 엔드 검사를 위해 일회용 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 스크립팅은 여전히 모든 UI 작업을 깔끔하게 노출하지는 않습니다.

  • 전문적인 타이틀 디자인은 여전히 실제 MOGRT 자산이나 외부 그래픽 워크플로우에 의존합니다.

  • get_render_queue_status는 Adobe Media Encoder 통합을 사용할 수 있을 때만 유용합니다.

  • 실제 소스 영상, 실제 오디오 및 실제 브랜드 자산을 사용할 때 최상의 결과가 나옵니다. 자동화 계층은 이를 조립하고 조작할 뿐, 편집자의 판단을 대체하지는 않습니다.

문제 해결

도구는 보이지만 호출이 실패하는 경우:

  1. 프로젝트가 로드된 상태에서 Premiere Pro가 열려 있는지 확인하세요.

  2. 창 > 확장 프로그램 > MCP Bridge (CEP)를 엽니다.

  3. 임시 디렉토리가 정확히 /tmp/premiere-mcp-bridge인지 확인하세요.

  4. 브리지 시작을 클릭하세요.

  5. 브리지 코드를 업데이트한 경우 패널을 마우스 오른쪽 버튼으로 클릭하고 새로 고침을 선택하세요.

  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

Available Tools

5 tools
get_tool_schemaA

Return the full JSON input schema for one Premiere tool name from search_tools. After reading it, call invoke_tool.

Inputs: name (required).

invoke_toolA

Run a Premiere tool by exact name. Use after search_tools. Hosts that only advertise the small always-on set cannot call trim_clip etc. as top-level MCP tools.

Inputs: name (required), arguments.

list_sequencesB

Lists all sequences in the current Premiere Pro project with their IDs, names, and basic properties.

Inputs: no named parameters.

search_toolsA

Search the Premiere tool catalog with a BM25 natural-language query or a regex pattern, then call invoke_tool. Use this instead of expecting 280 editing tools in the MCP tool list. Empty query lists categories. Default 5 matches.

Inputs: limit, query, detail, pattern.

verify_premiere_connectionA

Readiness check for Premiere Pro and the MCP Bridge. Call this before any editing tool. If Premiere is installed and not running, this launches it and waits for the CEP panel, which auto-starts the bridge. If it fails, tell the user the nextStep and do not retry other tools.

Inputs: launchIfNeeded.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool occupies a distinct role in the bridge workflow: connection readiness, catalog search, schema lookup, tool invocation, and sequence listing. The search/schema/invoke tools form a clear sequence with explicit handoffs, so an agent should not confuse them.

    Naming Consistency5/5

    All tool names follow lowercase snake_case with a verb_noun structure: verify_premiere_connection, search_tools, get_tool_schema, invoke_tool, list_sequences. There are no mixed conventions or vague overloaded verbs.

    Tool Count5/5

    Five tools is well-scoped for a server that intentionally exposes a 280-tool catalog through a compact bridge layer rather than flooding the MCP tool list. Each tool is necessary for the discovery-and-invocation lifecycle.

    Completeness5/5

    The surface covers the full interaction loop: verify connection, search available tools, get a schema, invoke any cataloged tool, and list sequences directly. Since invoke_tool can execute any Premiere tool, there are no obvious missing operations for the server's stated purpose.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers