Package Exports

@vibeframe/mcp-server
@vibeframe/mcp-server/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@vibeframe/mcp-server) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@vibeframe/mcp-server

MCP (Model Context Protocol) server for VibeFrame - AI-native video editing.

Edit video timelines with natural language through Claude Desktop, Cursor, or any MCP client.

Quick Setup

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "vibeframe": {
      "command": "npx",
      "args": ["-y", "@vibeframe/mcp-server"]
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "vibeframe": {
      "command": "npx",
      "args": ["-y", "@vibeframe/mcp-server"]
    }
  }
}

What You Can Do

Once connected, ask your AI assistant:

"Create a new video project called Demo"

"Add intro.mp4 to the project and export it as output.mp4"

"Remove silent segments from my video"

"Add captions to my video with bold style"

"Generate a video from this script: A sunrise over the ocean..."

"Extract 3 highlight clips from my interview recording"

Available Tools (28)

Project Management (2)

Tool	Description
`project_create`	Create a new `.vibe.json` project
`project_info`	Get project metadata

Timeline Operations (10)

Tool	Description
`timeline_add_source`	Import media (video/audio/image)
`timeline_add_clip`	Add clip to timeline
`timeline_split_clip`	Split clip at time
`timeline_trim_clip`	Trim clip start/end
`timeline_move_clip`	Move clip to new position
`timeline_delete_clip`	Remove clip
`timeline_duplicate_clip`	Duplicate clip
`timeline_add_effect`	Apply effect (fade, blur, etc.)
`timeline_add_track`	Add video/audio track
`timeline_list`	List all project contents

Export (1)

Tool	Description
`export_video`	Export project to MP4/WebM/MOV via FFmpeg

AI Editing (7)

Tool	Description	API Key
`edit_silence_cut`	Remove silent segments	None (FFmpeg) or GOOGLE (Gemini)
`edit_caption`	Transcribe + burn styled captions	OPENAI (Whisper)
`edit_fade`	Fade in/out effects	None (FFmpeg)
`edit_noise_reduce`	Audio/video noise removal	None (FFmpeg)
`edit_jump_cut`	Remove filler words	OPENAI (Whisper)
`edit_text_overlay`	Apply text overlays	None (FFmpeg)
`edit_translate_srt`	Translate SRT subtitles	ANTHROPIC or OPENAI

AI Analysis (4)

Tool	Description	API Key
`ai_analyze`	Unified media analysis (image/video/YouTube)	GOOGLE
`ai_gemini_video`	Video analysis with temporal understanding	GOOGLE
`ai_review`	AI video review + auto-fix	GOOGLE
`ai_thumbnail`	Extract best thumbnail frame	GOOGLE

AI Pipelines (4)

Tool	Description	API Key
`ai_script_to_video`	Full script-to-video pipeline	Multiple (varies by provider)
`ai_highlights`	Extract highlight clips	OPENAI+ANTHROPIC or GOOGLE
`ai_auto_shorts`	Generate short-form content	OPENAI+ANTHROPIC or GOOGLE
`ai_narrate`	Auto-generate narration	GOOGLE + ELEVENLABS

Resources

URI	Description
`vibe://project/current`	Full project state
`vibe://project/clips`	All clips
`vibe://project/sources`	Media sources
`vibe://project/tracks`	Track list
`vibe://project/settings`	Project settings

Prompts

Prompt	Description
`edit_video`	Get guidance on editing a video with natural language instructions
`create_montage`	Create a montage from multiple clips with automatic pacing
`add_transitions`	Add transitions between clips in the timeline
`color_grade`	Apply color grading to clips
`generate_subtitles`	Generate subtitles from audio using AI transcription
`create_shorts`	Create short-form content from a longer video
`sync_to_music`	Sync video cuts to music beats

Environment Variables

Variable	Used By	Description
`VIBE_PROJECT_PATH`	Resources	Default project file path
`OPENAI_API_KEY`	caption, jump-cut, translate-srt, highlights	Whisper + GPT
`ANTHROPIC_API_KEY`	translate-srt, highlights, script-to-video	Claude
`GOOGLE_API_KEY`	analyze, gemini-video, review, thumbnail, narrate	Gemini
`ELEVENLABS_API_KEY`	narrate, script-to-video	TTS
`RUNWAY_API_SECRET`	script-to-video	Video generation
`KLING_API_KEY`	script-to-video	Video generation

Requirements

Node.js 18+
FFmpeg (for export, editing, and pipeline tools)

License

MIT