SkillAgentSearch skills...

avid-media-composer-mcp

Avid Media Composer MCP server for AVB, AAF, ALE, EDL, project, and media analysis with source-safe guarded automation.

Install / Use

claude mcp add leancoderkavy -- npx -y github:leancoderkavy/avid-media-composer-mcp

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

81/100

Category

Automation

Supported Platforms

Claude Code
Claude Desktop

Our assessment of avid-media-composer-mcp

avid-media-composer-mcp scores 81/100 on our quality scale, 2333rd of 2,780 Automation skills we index.

Its MCP Server is 24 KB long, well organised into 24 sections with 13 code examples: a thorough specification that gives an agent plenty to work with.

It has 10 GitHub stars, so there is little community track record yet; judge it on its content.

Substance
30/30
Structure
20/20
Description
12/15
Adoption
4/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated today, so avid-media-composer-mcp is actively maintained.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 97/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-11-13. Automated pattern scan on 2026-11-13. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

avid-media-composer-mcp compared with similar skills

All 4 of these similar skills score higher than avid-media-composer-mcp; compare them before choosing.

SkillScoreStarsUpdatedFormat
avid-media-composer-mcp (this skill)by leancoderkavy8110todayMCP Server
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md
CowAgentby zhayujie10048.0ktodayCLAUDE.md

Frequently asked questions

How do I install avid-media-composer-mcp?
Run claude mcp add leancoderkavy -- npx -y github:leancoderkavy/avid-media-composer-mcp. The install tabs above show the steps for each supported agent.
Which AI agents does avid-media-composer-mcp work with?
It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
Is avid-media-composer-mcp safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 97/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is avid-media-composer-mcp still maintained?
The repository was last updated today, so avid-media-composer-mcp is actively maintained.

Avid Media Composer MCP Server

An independent, source-safe Model Context Protocol (MCP) server that lets AI assistants inspect Avid Media Composer projects — bins, interchange, locks, configuration evidence, and media metadata — and prepare guarded live edits only through a compatible Extension bridge.

Listing summary: connect Claude, Cursor, VS Code, Codex, LM Studio, or any standards-compatible MCP client to local Avid project evidence. Offline analysis is read-only and confined to AVID_MCP_ALLOWED_ROOTS. Live timeline mutation is fail-closed without a bridge that advertises the operation. MIT-licensed. Founder: Kavy Rattana. Not affiliated with or endorsed by Avid Technology, Inc.

Website · Setup · Capabilities · Security · npm · Draft marketing pack

Format and workflow references: AVB files · AAF files · ALE files · EDL files · Avid bin locking · Compatibility matrix · AI and automation

Use it with an MCP client that can launch a local process or reach the configured authenticated HTTP server. The published 1.1.0 package provides analysis, interchange and bridge contracts, and it is what npx and the latest distribution tag install today. Version 1.2.0-rc.1 is cut in this repository and adds local media intelligence, installation helpers and a separate Windows native adapter, but it has not been published to npm yet; run it by building from source until that release candidate ships. A compatibility-rule result is not proof of this connector running on that host; native runtime evidence currently covers the qualified Windows Media Composer 2024.12 build described in implementation status. Mac implementation and host qualification are deferred.

The server also defines a 167-action editing catalog and a tested bridge protocol. Catalog actions require a compatible Extension that advertises each operation. The separate native adapter has its own bounded operations, authority checks and host qualification; the catalog does not describe its coverage.

Also from this author: Premiere Pro MCP

Editors who work across both NLEs may also want Premiere Pro MCP, an MCP server for Adobe Premiere Pro workflows by the same author (Kavy Rattana).

Avid, Media Composer, MediaCentral, and related marks belong to Avid Technology, Inc. This independent project is not affiliated with or endorsed by Avid.

Development branch notes

These changes are not in the public 1.1.0 package, and the 1.2.0-rc.1 candidate that contains them is not on npm yet. Skip to Facts at a glance for the released server. See local setup for running this checkout and implementation status for what each addition has and has not proven.

Local media intelligence. This checkout indexes local media by content hash and adds bounded search, QC and reporting over that index: technical metadata and facets, black/freeze/silence and loudness measurement, contact sheets, thumbnail strips, transcript and speaker workflows, visual and people indexes, and verified copies or trims that leave the source untouched. avid_timecode_continuity assesses declared container and stream timecode across indexed files, handling drop-frame numbering for 29.97 and 59.94, and reports contiguous, gap, overlap or incomparable pairs from metadata alone. Longer analysis runs as cancellable local jobs whose status survives reconnecting; see audio sync research and watch folder recovery.

Saved-project inspection. Snapshots of saved AVB bins support paginated marker inspection with text, color declarations and explicitly unresolved or effect-input locations, timeline range and source-usage queries, sequence complexity, snapshot diffing, checksum verification against current bytes, filtered clip search described in saved snapshot search, and metadata-only file availability checks in saved locator availability. These are saved-file facts and exclude unsaved editor state.

Guarded native adapter. On the qualified Windows build the adapter performs bounded operations with capability checks, single-use tokens and post-write verification: clip Comments set and clear, AAF selects import, bin-column discovery, batch marker removal, clip duplication, clip renaming that checks the expected current name, media-volume declarations, and bin-scoped track and viewer inspection. Source-viewer loading verifies the requested MOB ID for the sequence case, while source-master identity mapping remains unresolved and Record and seek options are not exposed. None of this establishes full timeline editing or atomic undo.

Runtime and recovery. An isolated Python runtime can be installed into a new directory with a checksum-verified bootstrap and read-only status checks, so bin inspection no longer depends on ambient interpreter settings. Interrupted work is discoverable rather than replayed: watch folders recover crashed owner locks without discarding checkpoints, and source-clock preparation records attempts, publishes receipts as complete files and reports unresolved runs explicitly. Windows worker cancellation retains classified termination counts for diagnosis without storing raw command output.

Workflow skills. Original workflow skills cover ingest/QC, selects, review markers, turnover and export.

Facts at a glance

| Question | Answer | | --- | --- | | What is this? | An open-source MCP server for Avid Media Composer analysis and guarded automation. | | What can it inspect? | AVB bins, AAF files, ALE logs, EDLs, OTIO JSON, AVP/AVS configuration evidence, project trees, locks, and media metadata. | | Does it modify Avid projects offline? | No. Offline analysis is read-only and source media is never modified. | | Can it edit a live Media Composer session? | This development branch has guarded native operations for the qualified Windows 2024.12 build. General editing catalog actions still require a separately installed compatible Extension bridge. | | Which systems are supported? | Windows native evidence is build-specific. Offline compatibility rules cover additional Avid/OS combinations; those rules do not establish connector runtime qualification. Mac work is deferred. | | Which AI clients can use it? | Any standards-compatible MCP client that can launch a local stdio server or connect to authenticated Streamable HTTP. | | Is it an official Avid product? | No. It is an independent MIT-licensed project. |

What works now

The following list describes the published analysis foundation. For the development branch's local visual search, transcription, people/speaker workflows, QC, saved snapshots and native operations, see the current implementation and remaining acceptance work. Tool discovery through tools/list is authoritative for the installed package; the development package currently exposes 145 tools, including offline and bridge tools.

  • Recursively inventory and classify project, bin, setting, lock, interchange, sidecar, document, and media files.
  • Detect active or orphaned .lck bin locks.
  • Analyze AVB object graphs, bin views, mobs, tracks, clips, sequences, and metadata through pyavb.
  • Analyze AAF mobs, slots, components, essence, descriptors, definitions, and metadata through pyaaf2.
  • Parse every ALE heading, column, and row.
  • Parse CMX-style EDL events, transitions, comments, clip names, and motion-effect lines.
  • Validate source-marker packages and a strict static SVG-overlay subset before import.
  • Compare transcript revisions locally without returning transcript text.
  • Assess supplied DNx/DNx 4.0 turnover metadata and compatibility risks without transcoding.
  • Preview conservative OTIO handoffs with local-media manifests, optional checksums, and relink blockers.
  • Read an explicitly configured, allowlisted MediaCentral CTMS HAL registry without mutation.
  • Read OTIO JSON structurally with bounded input/depth/object limits, flagging transitions, effects, retimes, nested timelines, media references, and audio-routing risks that need Media Composer confirmation.
  • Decode text-like AVP/AVS/configuration files; fingerprint, measure, and string-extract opaque binary files without pretending their semantics are known.
  • Inspect container and stream metadata through ffprobe, with optional frame/packet counting and SHA-256 hashing.
  • Preview compound editing plans, classify risk, require destructive opt-in, and bind approval to an exact SHA-256 confirmation token.
  • Report enabled authority, dependency health, source coverage, truncation, provider gates, and live bridge status.
  • Evaluate Media Composer/Windows/macOS/architecture combinations against source-linked Avid rules.
  • Detect standard Media Composer application locations on Windows and macOS.

Common use cases

  • Ask an AI assistant to audit an Avid project before conform, turnover, migration, or archive.
  • Summarize bins, sequences, tracks, clips, markers, and metadata from AVB or AAF evidence.
  • Validate ALE, EDL, and OTIO interchange files and identify missing, opaque, malformed, or fidelity-sensitive data.
  • Inventory project files, detect active or orphaned bin locks, and report collaboration risks.
  • Inspect codec, container, duration, frame-rate, timecode, and stream metadata through ffprobe.
  • Check whether a Media Composer version is qualified for the detected Windows or macOS environment.
  • Preview a bounded edit plan and require exact confirmation before a connected extension can apply it.

What still requires Avid access

The Media Composer Extensions SDK (formerly Panel SDK) is the separate sanctioned integration path for the Extension bridge. SDK access and an installed compatible Extension remain prerequisites for that path. The development Windows native adapter uses the locally installed, checksum-qualified Avid binary and verifies the loopback listener owner; it does not require or distribute the private SDK. See native adapter setup and limits.

For the Extension path, until that bridge exists:

  • avid_get_live_state fails closed with BRIDGE_NOT_CONNECTED.
  • avid_apply_edit_plan fails closed even when the edit capability is enabled.
  • An action appearing in the catalog is a planned contract, not evidence that Media Composer performed it.

See RESEARCH.md, supported versions, the capability matrix, and the bridge contract.

Architecture

flowchart LR
    Client[MCP client] -->|stdio| Server[TypeScript MCP server]
    Server --> Native[Native project / ALE / EDL / config analyzers]
    Server --> Python[Bounded Python inspector]
    Python --> AVB[pyavb]
    Python --> AAF[pyaaf2]
    Server --> Probe[ffprobe, optional]
    Server -->|qualified Windows build| Adapter[Guarded native adapter]
    Adapter -

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars10
CategoryAutomation
Updated8h ago
Forks0

Languages

TypeScript

Trust signals

97/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 info