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-mcpIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
AutomationSupported Platforms
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.
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 foundOur 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.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| avid-media-composer-mcp (this skill)by leancoderkavy | 81 | 10 | today | MCP Server |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| CowAgentby zhayujie | 100 | 48.0k | today | CLAUDE.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.
Skill content
View source on GitHubAvid 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.0package, and the1.2.0-rc.1candidate 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
.lckbin 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_statefails closed withBRIDGE_NOT_CONNECTED.avid_apply_edit_planfails closed even when theeditcapability 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
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
CowAgent
48.0kOpen-source personal AI assistant & Agent Harness. Plans tasks, runs tools and skills, self-evolves with memory and knowledge. Multi-agent, multi-model, multi-channel. Lightweight, extensible, one-line install.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
