Open-source Model Context Protocol server

Avid Media Composer MCP for AI workflows.

Inspect Media Composer projects, AVB bins, AAF, ALE, EDL, locks, configurations, and media metadata with source-safe tools built for post-production.

View setup guide Capability matrix
AvEpisode_101Project audit
MCP connected

Project connected

Episode_101

Scanning project structure and bin locks
01:04:18:12
00:01 / 00:10
AI project auditRead-only

Indexing 184 project files

6 bins discovered
Allowed root verified
1 active bin lock
Read-only analysisSource-safe by default
Windows + macOSQualified Avid releases
Fail-closed editingExact confirmation tokens
MIT licensedIndependent open source

What works now

Structured evidence.
Not screen scraping.

Purpose-built analyzers expose useful editorial context while preserving unknown or proprietary data as clearly labeled evidence.

Project and bin intelligence

Inventory project trees, detect active or orphaned locks, and inspect AVB clips, sequences, tracks, views, and metadata.

Interchange validation

Parse AAF, ALE, and CMX-style EDL structures while identifying missing, malformed, truncated, or opaque data.

Media inspection

Use ffprobe for codec, container, stream, duration, frame-rate, timecode, packet, frame, and optional hash evidence.

Compatibility checks

Evaluate Media Composer, operating system, and architecture combinations against source-linked qualification rules.

Guarded edit plans

Preview bounded plans, classify risk, require destructive opt-in, and bind approval to an exact SHA-256 token.

Explicit bridge state

Report heartbeat freshness and supported operations. No bridge, stale state, or unsupported action means no live edit.

Projectavid_analyze_project
AVBavid_analyze_bin
AAFavid_analyze_aaf
ALEavid_analyze_ale
EDLavid_analyze_edl
Mediaavid_analyze_clip
Filesavid_inventory_project_files
Systemavid_check_compatibility
Bridgeavid_get_bridge_status
Safetyavid_preview_edit_plan
Projectavid_analyze_project
AVBavid_analyze_bin
AAFavid_analyze_aaf
ALEavid_analyze_ale
EDLavid_analyze_edl
Mediaavid_analyze_clip
Filesavid_inventory_project_files
Systemavid_check_compatibility
Bridgeavid_get_bridge_status
Safetyavid_preview_edit_plan

Two independent lanes

Useful offline. Guarded when live.

Analysis never needs to pretend the editor is connected. Live control never silently falls back to UI automation.
01

MCP client

Claude, ChatGPT, Codex, Cursor, or another standards-compatible client.

02

TypeScript server

Allowed-root enforcement, native parsers, bounded Python inspection, and risk controls.

03

Analysis lane

AVB · AAF · ALE · EDL · media

Live-control lane

Compatible Avid Extension required

Local setup

Run beside your Avid project.

Start with inspect-only authority. Add the Python dependencies for AVB and AAF analysis, and ffprobe when media inspection is needed.
  1. 1Clone and installNode.js 20+ and Python 3.9+
  2. 2Set allowed project rootsKeep authority scoped to known folders
  3. 3Connect your MCP clientUse the local stdio command
# PowerShell
git clone https://github.com/leancoderkavy/avid-media-composer-mcp
cd avid-media-composer-mcp
npm ci
python -m pip install -r python/requirements.txt
npm run build

$env:AVID_MCP_CAPABILITIES = "inspect"
node .\dist\index.js

Live Media Composer editing requires a separately installed, compatible Avid Extension bridge. The server does not claim edits from previews or catalog entries.

Frequently asked questions

Avid MCP, clearly bounded.

Straight answers about supported formats, privacy, compatibility, and live editing.
Is there an MCP server for Avid Media Composer?+

Yes. This project provides a working MCP server for read-only Avid Media Composer project analysis. Guarded live editing requires a compatible Avid Extension bridge.

Which Avid formats can it analyze?+

It analyzes AVB through pyavb, AAF through pyaaf2, ALE and EDL with native parsers, AVP and AVS as text or bounded binary evidence, and media containers through ffprobe.

Does it modify project files or footage?+

Offline analysis is read-only and source media is never modified. The server also enforces explicit allowed roots and reports opaque evidence instead of guessing.

Can it edit a live Media Composer timeline?+

Only through a separately installed, compatible Avid Extension bridge. Without a fresh bridge that advertises the requested operation, live editing fails closed.

Which Media Composer releases are supported?+

The current compatibility contracts cover Media Composer 2025.12.x, 2025.6, and the 2024.12.x long-term-maintenance release track on qualified Windows and macOS combinations.

Build a safer AI-assisted post workflow.

Start with the project evidence.

Explore on GitHub