Skip to main content
Glama

🎬 Vibie MCP

The Universal AI "Vibe Video Editor" MCP for FilmCraft & Adobe Premiere Pro

License: MIT Node.js TypeScript MCP FilmCraft Adobe Premiere Pro

Vibie is a next-generation Model Context Protocol (MCP) server that empowers AI assistants to edit video natively across FilmCraft (the open-source Premiere Pro clone in pure Rust) AND Adobe Premiere Pro (via an included 1-click CEP panel extension).

Powered by TypeScript, FFmpeg, OpenCV, and HyperFrames (HeyGen).


🌟 Why Vibie?

Traditional video editing involves hours of repetitive friction: cutting dead air, syncing audio, hunting down clips, reframing 16:9 shots to 9:16 vertical reels, and building lower thirds.

Vibie bridges human taste with agentic execution:

  • 🔄 Dual-Engine Interoperability: Seamlessly controls FilmCraft (native 127.0.0.1:9876 socket) OR Adobe Premiere Pro (included CEP panel on 127.0.0.1:9877). Auto-detects whichever NLE is running!

  • 🏎️ Fast Assembly: Remove silences and generate rough cuts in seconds with FFmpeg.

  • 🎯 AI Object Masking: Select subjects and generate organic polygon contours via OpenCV even before native AI masks land in FilmCraft.

  • 📱 Smart 9:16 Auto-Reframe: Smoothly pan-and-scan horizontal footage for TikTok and YouTube Shorts by tracking faces.

  • 🎨 HyperFrames Graphics: Render dynamic, animated lower thirds, chapter cards, and subtitles directly from HTML/CSS to timeline tracks V2 and V3.

  • 🛡️ Safe & Reviewable: Every mutation generates structured audit receipts and undo checkpoints so you never lose work.


Related MCP server: fcp-mcp-server

🏗️ Architecture

flowchart TD
    subgraph Client["AI Assistants"]
        Claude["Claude Desktop / Claude Code"]
        Cursor["Cursor / Windsurf / Codex"]
        Agy["Google Antigravity"]
    end

    subgraph Vibie["Vibie MCP Server (TypeScript Host)"]
        Router["Unified Bridge & Host Auto-Detector"]
        Packs["Tool Packs (Essential, Editorial, Audio, Color, Vision, Full)"]
        
        subgraph Intelligence["Open-Source Processing Engines"]
            FFmpeg["FFmpeg Core\n• Silence detection\n• EBU R128 Loudness (-14 LUFS)\n• Scene change detection"]
            OpenCV["OpenCV Vision Sidecar\n• AI Object Selection\n• Face & Subject Tracking\n• 9:16 Auto-Reframe"]
            Hyper["HyperFrames Engine\n• HTML/CSS Motion Graphics\n• Kinetic Typography\n• Animated Lower Thirds"]
        end
    end

    subgraph Hosts["Connected NLE Video Editors"]
        subgraph FilmCraftApp["FilmCraft (Free & Open Source)"]
            FCSocket["Native TCP Loopback (127.0.0.1:9876)"]
            FCTimeline["Timeline Engine (Exact Integer Ticks)"]
        end
        
        subgraph PremiereApp["Adobe Premiere Pro"]
            CEPExt["Vibie CEP Extension Panel (127.0.0.1:9877)"]
            PPRODOM["Premiere Pro ExtendScript DOM Engine"]
        end
    end

    Client <--> Vibie
    Vibie <--> FFmpeg & OpenCV & Hyper
    Router -->|Auto-Route| FCSocket
    Router -->|Auto-Route| CEPExt
    FCSocket <--> FCTimeline
    CEPExt <--> PPRODOM

🧰 Available Tools & Domains

Domain

Tool Name

Description

Host Control

vibie_detect_hosts

Detects whether FilmCraft, Adobe Premiere Pro, or both are online.

vibie_set_target_host

Switch active editing destination between filmcraft, premiere, or auto.

Inspection

filmcraft_inspect_timeline

Deep scan of active sequence, tracks, clips, and playhead.

filmcraft_capture_frame

Grab the Program Monitor frame for visual AI inspection.

filmcraft_add_marker

Add timestamped editorial feedback notes and colored markers.

Timeline

filmcraft_place_clip

3-point insert/overwrite media onto tracks (V1, V2, A1, A2).

filmcraft_razor_cut

Split clips across tracks at exact second or playhead timecode.

filmcraft_ripple_delete

Remove clips or empty gaps and auto-close spacing.

filmcraft_slip_slide

Micro-adjust clip in/out points while preserving timeline position.

filmcraft_silence_remover

Auto-detect dead air with FFmpeg and batch ripple-delete.

Audio

filmcraft_audio_gain

Normalize clip peaks or set decibel levels.

filmcraft_essential_sound_ducking

Auto-duck background music beds beneath dialogue.

filmcraft_measure_loudness

Check broadcast EBU R128 loudness and gain offsets to -14 LUFS.

Color

filmcraft_lumetri_grade

Fine-tune exposure, contrast, temperature, highlights, and shadows.

filmcraft_lumetri_match

Match color grading between two clips using reference timecodes.

Vision

filmcraft_object_select_mask

Isolate people or subjects with organic polygon mask contours.

filmcraft_auto_reframe_vertical

Pan-and-scan horizontal video to vertical 9:16 Shorts with face tracking.

Graphics

filmcraft_generate_lower_third

Render sleek animated speaker overlays with HyperFrames.

filmcraft_generate_title_card

Render kinetic typography title cards.

Export

filmcraft_export_sequence

Trigger hardware NVENC/VideoToolbox or software render exports.

filmcraft_export_markers

Export sequence review notes to CSV.


⚡ Quickstart

1. Requirements

  • Node.js v20+

2. Connect Your Editor

For FilmCraft (Free & Open Source):

Run FilmCraft with the control flag:

# Windows: Double-click extensions/filmcraft/launch-control.bat or run:
filmcraft --control 9876

For Adobe Premiere Pro:

Install the included 1-click CEP panel:

  • Windows: Double-click extensions/premiere/install-premiere.bat

  • macOS: Run bash extensions/premiere/install-premiere.sh

  • Then launch Premiere Pro and open: Window > Extensions > Vibie MCP Bridge.


3. Setup in Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "vibie": {
      "command": "node",
      "args": ["d:/MCP Vibie/dist/index.js"],
      "env": {
        "VIBIE_TARGET": "auto",
        "VIBIE_PACK": "full"
      }
    }
  }
}

4. Setup in Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "vibie": {
      "command": "node",
      "args": ["d:/MCP Vibie/dist/index.js"]
    }
  }
}

🎯 Pre-Built Workflow Prompts

Vibie includes guided prompts out of the box:

  • vibie_rough_cut: Ingest footage, detect pauses with FFmpeg, ripple-delete silences, and normalize dialogue to -14 LUFS.

  • vibie_podcast_shorts_generator: Convert a podcast moment into a 9:16 vertical short, track the speaker, duck background music, and add a lower third.

  • vibie_ai_object_mask: Inspect the frame and segment subjects using OpenCV contours.


🤝 Contributing & Community

Vibie is 100% open-source under the MIT License. Contributions, issues, and feature requests are welcome!

Made with ❤️ for both the FilmCraft open-source community and the global Premiere Pro editorial community.

Available Tools

26 tools
filmcraft_add_markerB

Adds a colored editorial or review marker at a specific timecode with notes.

Inputs: name (required), seconds (required), color, comment.

filmcraft_audio_gainC

Adjusts the audio volume gain of selected audio clips in decibels (dB).

Inputs: db (required), mode (required), clipIds (required).

filmcraft_auto_reframe_verticalB

Converts horizontal 16:9 footage into 9:16 vertical video for YouTube Shorts/TikTok by tracking the subject.

Inputs: clipId (required), targetSubject.

filmcraft_capture_frameB

Captures the current rendered frame from the FilmCraft Program Monitor for AI vision models to inspect visually.

Inputs: outputFileName.

filmcraft_create_binC

Creates a new organizational bin/folder in the FilmCraft project panel.

Inputs: name (required), parentBinId.

filmcraft_essential_sound_duckingC

Automatically ducks background music audio underneath dialogue tracks with smooth fades.

Inputs: musicClipIds (required), reduceDb, duckingAgainst, fadeDurationSec.

filmcraft_export_markersB

Exports sequence review markers and timestamped editorial notes to a CSV document.

Inputs: csvOutputPath (required).

filmcraft_export_sequenceB

Renders and exports the active FilmCraft sequence to video using hardware or software encoders.

Inputs: outputPath (required), preset, exportRange, hardwareAcceleration.

filmcraft_generate_lower_thirdB

Uses HyperFrames to generate an animated Lower Third graphic overlay for speakers or chapters.

Inputs: primaryText (required), secondaryText (required), accentColor, targetTrack, +1 more.

filmcraft_generate_title_cardC

Uses HyperFrames to generate a cinematic or modern title card with animated typography.

Inputs: heading (required), theme, subheading, durationSeconds.

filmcraft_import_mediaB

Imports audio, video, or graphic media files into the active FilmCraft project bin.

Inputs: filePaths (required), binName.

filmcraft_inspect_projectA

Inspects the active FilmCraft or Premiere Pro project, returning the project name, bins, imported media clips, durations, and active sequence.

Inputs: no named parameters.

filmcraft_inspect_timelineA

Inspects the active sequence on the FilmCraft timeline, returning track structures, placed clips, durations, and playhead position.

Inputs: no named parameters.

filmcraft_lumetri_gradeC

Adjusts Lumetri color grade parameters (exposure, contrast, temperature, highlights, shadows, curves) on a timeline clip.

Inputs: clipId (required), tint, shadows, contrast, +4 more.

filmcraft_lumetri_matchB

Auto-matches color grade of a target clip against a reference frame/clip timecode with face detection awareness.

Inputs: clipId (required), referenceTimecode (required), faceDetection.

filmcraft_measure_loudnessB

Measures EBU R128 integrated loudness, True Peak, and Loudness Range (LRA) using FFmpeg.

Inputs: audioOrVideoPath (required), targetLufs.

filmcraft_new_projectB

Creates a new blank project in FilmCraft or Premiere Pro with the given name.

Inputs: name (required).

filmcraft_object_select_maskB

AI Object Select: Computes an organic segmented polygon mask around a subject/person/object and applies it to a clip effect mask.

Inputs: clipId (required), targetDescription (required), anchorPoint.

filmcraft_place_clipB

Places or overwrites a project media item onto a sequence timeline track (e.g. V1, V2, A1, A2).

Inputs: track (required), itemId (required), seconds (required), durationSeconds, +1 more.

filmcraft_razor_cutB

Performs a razor split (Add Edit) across clips at the specified timecode or active playhead.

Inputs: seconds (required), tracks.

filmcraft_ripple_deleteA

Deletes selected clips or empty gaps on the timeline, automatically shifting subsequent media left to close the gap.

Inputs: clipIds, gapRange.

filmcraft_save_projectB

Saves the active FilmCraft or Premiere Pro project to disk.

Inputs: path.

filmcraft_silence_removerA

AI Super-power: Scans media with FFmpeg for silent pauses, cuts them, and ripple-deletes them across the timeline in one click.

Inputs: mediaPath (required), minDurationSec, noiseThresholdDb.

filmcraft_slip_slideB

Performs a Slip or Slide trim on a timeline clip without shifting overall sequence timing.

Inputs: mode (required), clipId (required), offsetFrames (required).

vibie_detect_hostsA

Detects which video editors (FilmCraft, Adobe Premiere Pro, or both) are currently online and reachable.

Inputs: no named parameters.

vibie_set_target_hostB

Switches which video editor receives edits (FilmCraft or Adobe Premiere Pro).

Inputs: target (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 26 tools

    Disambiguation4/5

    Tools are mostly grouped by distinct resources and actions: host management, project inspection, timeline editing, media import, audio, color, graphics, and export. A few adjacent capabilities in audio cleanup, color matching, and subject-aware operations could be confused, but descriptions generally clarify their scopes.

    Naming Consistency4/5

    Nearly all tool names use consistent snake_case with clear namespaces, and most follow recognizable action-oriented patterns. Minor deviations include the vibie_ host-management prefix and the filmcraft_ prefix on new/save/inspect_project tools that also operate on Premiere Pro, plus a few noun-phrase names.

    Tool Count3/5

    The server exposes 26 tools, which is heavy for a single MCP surface even though the video-editing domain is broad and each tool maps to a specific operation. It sits at the borderline where grouping or presets could reduce sprawl.

    Completeness4/5

    Core FilmCraft workflows are covered end to end: host setup, project/media inspection, timeline editing, audio processing, color grading, AI masking/reframing, graphics generation, and export. Gaps remain for opening existing projects, deleting/updating bins or media, undo support, and full Premiere editing parity despite host switching.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables MCP-compatible AI assistants to control Adobe Premiere Pro through natural language, automating project and media management, timeline editing, color and audio adjustments, titles and markers, and batch exports via a local bridge.
      8,356 npm
      1
      MIT
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables Claude and other MCP clients to read, edit, and generate real Final Cut Pro timelines from FCPXML, including cut detection, markers, roles, silence removal, transcript-based editing, cross-NLE export, and pushing changes into a running Final Cut Pro. Every write is journaled and undoable, with validation and safety checks for reliable timeline edits.
      -