MCP Auto Clipper
Integrates Google AI models as a provider for transcription, highlight detection, clip planning, and metadata generation, with automatic fallback to other providers.
Integrates OpenAI AI models as a provider for transcription, highlight detection, clip planning, and metadata generation, with automatic fallback to other providers.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
MCP Auto Clipper
An intelligent, multi-provider AI video clipping system that automatically transforms long-form videos into viral-ready short-form clips (9:16 portrait) with subtitles, metadata, and quality control.
Features
Multi-Provider AI: OpenAI, Anthropic, Google with automatic fallback
Full Pipeline: Ingestion → Transcription → Highlight Detection → Clip Planning → Subtitles → Rendering → Metadata → QC
MCP Server: Model Context Protocol server with 9 tools, 4 resources, 2 prompts
Persistent Queue: BullMQ (Redis) with in-memory fallback
SQLite Database: sql.js WASM for zero-native-dependency persistence
Security Guardrails: Filesystem, URL, API key, and MCP tool protection
Agent Skill: Compatible with Claude Code and OpenCode
Quality Control: 9 automated checks with auto-correction (max 2 retries)
Related MCP server: VE-MCP
Quick Start
Prerequisites
Node.js 18+
FFmpeg & FFprobe (native installation)
At least one AI provider API key
Installation
# Clone and install
git clone <repo>
cd mcp-auto-clipper
npm install
# Build
npm run build
# Configure environment
cp .env.example .env
# Edit .env with your API keysConfiguration
Edit .env with your settings:
# Required: At least one AI provider
OPENAI_API_KEY=your-key
# ANTHROPIC_API_KEY=your-key
# GOOGLE_API_KEY=your-key
# Optional: Redis for production queue
REDIS_ENABLED=falseRunning
# Start MCP server (for Claude Code/OpenCode)
npm run start:mcp
# Start worker (processes jobs)
npm run start:worker
# Development mode
npm run devMCP Tools
Tool | Description |
| Full video processing pipeline |
| Check job progress |
| Cancel queued/processing job |
| Retry failed job |
| List processed videos |
| Technical video metadata |
| Queue statistics |
| Get settings |
| Update setting |
Agent Skill Usage
Claude Code
# Skill auto-loaded from .claude/skills/auto-clipper/
/auto-clipper import ./video.mp4
/auto-clipper create-clips ./video.mp4
/auto-clipper batch ./videos/OpenCode
# Skill auto-loaded from .opencode/skill/auto-clipper/
/auto-clipper import ./video.mp4Architecture
src/
├── config/ # Configuration & database
├── database/ # SQLite schema, migrations, repositories
├── ai/ # Transcription, highlight detection
├── video/ # FFmpeg engine, ingestion, clip planning
├── subtitle/ # SRT/ASS generation, burning
├── metadata/ # Viral metadata, scoring
├── qc/ # Quality control
├── queue/ # BullMQ job queue
├── workers/ # Job processing workers
├── mcp/ # MCP server implementation
└── security/ # GuardrailsWorkflows
See skills/auto-clipper/workflows/ for detailed workflows:
auto-clip.md- Complete pipelineimport-video.md- Video validationanalyze-video.md- Technical analysisfind-highlights.md- AI highlight detectioncreate-clips.md- Clip renderingsubtitle-generation.md- Subtitlesgenerate-metadata.md- Viral metadataquality-control.md- QC & auto-correctionbatch-processing.md- Multiple videos
Strategies
Content-type optimized configurations in skills/auto-clipper/strategies/:
podcast.mdinterview.mdeducational.mdstorytelling.mdgaming.mdentertainment.md
Quality Standards
All output clips meet:
✅ 1080x1920 (9:16 portrait)
✅ H.264 / AAC in MP4
✅ Burned-in subtitles
✅ Duration 15-120s
✅ Bitrate ≥1M video, ≥64k audio
✅ Sync tolerance ±1s
Security
Filesystem access restricted to configured paths
URL imports validated (blocklist private IPs, metadata endpoints)
API keys managed with rotation & rate limiting
MCP tool calls rate-limited & parameter-validated
No external publishing without approval
Development
# Run tests
npm test
# Lint
npm run lint
# Type check
npm run buildLicense
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Clip videos into captioned shorts, add captions, and schedule posts from AI agents.
Turn long videos into AI-curated short clips: caption, reframe, thumbnail, schedule, and publish.
Clip long videos, render branded short-form video, schedule to TikTok, Reels, Shorts and X.
Turn long videos into captioned short clips for TikTok, Reels, Shorts and X from your AI.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceTurns long-form videos into short-form clips (TikTok/Reels) by reasoning over word-timestamped transcripts, with silence-aware rendering, STT-based validation, and optional reframing/captions.-
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to autonomously edit videos into publish-ready vertical short-form content, including silence removal, subtitle generation, voiceover synthesis, color grading, and composite pipeline creation.MIT
- FlicenseNot gradedqualityBmaintenanceEnables AI agents to autonomously edit raw video footage into publish-ready videos with millisecond-accurate cuts, Whisper transcription, karaoke captions, motion graphics, and high-CTR thumbnails.6-
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to turn a meeting recording and transcript into captioned clips, trailers, longform best-ofs, and 1:1/9:16/16:9 social videos. Agents can create projects, inspect transcripts, render jobs, check status, and retrieve output files.MIT