@studiomeyer/mcp-video 1.0.0

package/dist/tools/engine/voice-effects.js

@@ -0,0 +1,215 @@
+/**
+ * Voice Effects Engine — 9 audio effects via FFmpeg filter chains.
+ *
+ * Effects: echo, reverb, deep, chipmunk, robot, whisper, radio, megaphone, underwater.
+ * Works on both audio files and video files (preserves video stream).
+ */
+import { execFile } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+import { logger } from '../../lib/logger.js';
+export const ALL_VOICE_EFFECTS = [
+    'echo', 'reverb', 'deep', 'chipmunk', 'robot',
+    'whisper', 'radio', 'megaphone', 'underwater',
+];
+export const VOICE_EFFECT_DESCRIPTIONS = {
+    echo: 'Indoor/outdoor echo with configurable delay',
+    reverb: 'Dense multi-tap reverb (hall-like)',
+    deep: 'Lower pitch — deep/bass voice',
+    chipmunk: 'Higher pitch — chipmunk/squeaky voice',
+    robot: 'Metallic robotic voice (phase zeroing)',
+    whisper: 'Breathy whisper effect with randomized phase',
+    radio: 'AM radio / telephone quality (bandpass)',
+    megaphone: 'Distorted megaphone with resonance',
+    underwater: 'Muffled underwater sound (heavy lowpass)',
+};
+// ─── Effect Filter Builders ─────────────────────────────────────────
+function getEffectFilter(effect, intensity) {
+    const i = Math.max(0, Math.min(1, intensity));
+    switch (effect) {
+        case 'echo': {
+            // Scale delay and decay with intensity
+            const delay1 = Math.round(30 + i * 470); // 30-500ms
+            const delay2 = Math.round(60 + i * 940); // 60-1000ms
+            const decay1 = (0.2 + i * 0.3).toFixed(2); // 0.2-0.5
+            const decay2 = (0.1 + i * 0.2).toFixed(2); // 0.1-0.3
+            return { filter: `aecho=0.8:0.9:${delay1}|${delay2}:${decay1}|${decay2}` };
+        }
+        case 'reverb': {
+            // Dense multi-tap approximation of reverb
+            const taps = Math.round(3 + i * 7); // 3-10 taps
+            const delays = [];
+            const decays = [];
+            for (let t = 1; t <= taps; t++) {
+                delays.push(String(Math.round(t * 20)));
+                decays.push((0.6 - t * (0.5 / taps)).toFixed(2));
+            }
+            return { filter: `aecho=0.8:0.9:${delays.join('|')}:${decays.join('|')}` };
+        }
+        case 'deep': {
+            // Lower pitch: factor < 1.0 lowers pitch
+            // Intensity 0.0 → factor 0.95 (subtle), 1.0 → factor 0.5 (very deep)
+            const factor = 0.95 - i * 0.45; // 0.95 → 0.5
+            return { filter: '', needsComplexPitch: true, pitchFactor: factor };
+        }
+        case 'chipmunk': {
+            // Higher pitch: factor > 1.0 raises pitch
+            // Intensity 0.0 → factor 1.1 (subtle), 1.0 → factor 2.0 (extreme)
+            const factor = 1.1 + i * 0.9; // 1.1 → 2.0
+            return { filter: '', needsComplexPitch: true, pitchFactor: factor };
+        }
+        case 'robot': {
+            // Phase zeroing creates metallic robot effect
+            // At lower intensity, mix with short echo for metallic quality
+            if (i > 0.5) {
+                return { filter: "afftfilt=real='hypot(re,im)*sin(0)':imag='hypot(re,im)*cos(0)':win_size=512:overlap=0.75" };
+            }
+            // Lighter robot via very short echo
+            const delay = Math.round(3 + i * 10);
+            return { filter: `aecho=0.8:0.88:${delay}:${(0.3 + i * 0.3).toFixed(2)}` };
+        }
+        case 'whisper': {
+            if (i > 0.5) {
+                // Full whisper via phase randomization
+                return { filter: "afftfilt=real='hypot(re,im)*cos((random(0)*2-1)*2*3.14)':imag='hypot(re,im)*sin((random(1)*2-1)*2*3.14)':win_size=128:overlap=0.8" };
+            }
+            // Lighter whisper via filtering
+            const vol = (0.6 - i * 0.3).toFixed(2);
+            return { filter: `highpass=f=1000,lowpass=f=4000,volume=${vol}` };
+        }
+        case 'radio': {
+            // Bandpass gets narrower with intensity
+            const lowCut = Math.round(200 + i * 400); // 200-600 Hz
+            const highCut = Math.round(4000 - i * 2000); // 4000-2000 Hz
+            const crush = i > 0.5 ? `,acrusher=bits=${Math.round(12 - i * 6)}:mode=log:aa=1` : '';
+            return { filter: `highpass=f=${lowCut},lowpass=f=${highCut}${crush}` };
+        }
+        case 'megaphone': {
+            const bits = Math.round(12 - i * 6); // 12→6 bits
+            const vol = (1.5 + i * 1.0).toFixed(1);
+            return { filter: `highpass=f=500,lowpass=f=4000,acrusher=bits=${bits}:mode=log:aa=1:samples=1,aecho=0.8:0.88:10:${(0.3 + i * 0.3).toFixed(2)},volume=${vol}` };
+        }
+        case 'underwater': {
+            // Lowpass gets more extreme with intensity
+            const cutoff = Math.round(500 - i * 350); // 500→150 Hz
+            const vol = (0.9 - i * 0.3).toFixed(2);
+            const wobble = i > 0.3 ? `,flanger=delay=5:depth=${Math.round(1 + i * 4)}:speed=0.3` : '';
+            return { filter: `lowpass=f=${cutoff}${wobble},volume=${vol}` };
+        }
+        default:
+            throw new Error(`Unknown voice effect: ${effect}`);
+    }
+}
+// ─── Helpers ────────────────────────────────────────────────────────
+function runFfmpeg(args, timeoutMs = 300_000) {
+    return new Promise((resolve, reject) => {
+        execFile('ffmpeg', args, { maxBuffer: 100 * 1024 * 1024, timeout: timeoutMs }, (error, stdout, stderr) => {
+            if (error) {
+                logger.error(`ffmpeg failed: ${stderr}`);
+                reject(new Error(`ffmpeg failed: ${stderr || error.message}`));
+                return;
+            }
+            resolve(stdout);
+        });
+    });
+}
+function runFfprobe(args) {
+    return new Promise((resolve, reject) => {
+        execFile('ffprobe', args, { maxBuffer: 10 * 1024 * 1024 }, (error, stdout) => {
+            if (error) {
+                reject(new Error(`ffprobe failed: ${error.message}`));
+                return;
+            }
+            resolve(stdout.trim());
+        });
+    });
+}
+function ensureDir(filePath) {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+}
+function assertExists(filePath, label = 'File') {
+    if (!fs.existsSync(filePath))
+        throw new Error(`${label} not found: ${filePath}`);
+}
+function fileInfo(filePath) {
+    const stats = fs.statSync(filePath);
+    return `${(stats.size / 1024 / 1024).toFixed(2)} MB`;
+}
+async function hasVideoStream(filePath) {
+    try {
+        const result = await runFfprobe(['-v', 'quiet', '-select_streams', 'v', '-show_entries', 'stream=codec_type', '-of', 'csv=p=0', filePath]);
+        return result.length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+async function getSampleRate(filePath) {
+    try {
+        const result = await runFfprobe(['-v', 'quiet', '-select_streams', 'a:0', '-show_entries', 'stream=sample_rate', '-of', 'csv=p=0', filePath]);
+        const rate = parseInt(result, 10);
+        return isNaN(rate) ? 44100 : rate;
+    }
+    catch {
+        return 44100;
+    }
+}
+/** Build chained atempo filters (each must be 0.5-100.0 range) */
+function buildAtempoChain(speed) {
+    const filters = [];
+    let remaining = speed;
+    while (remaining > 2.0) {
+        filters.push('atempo=2.0');
+        remaining /= 2.0;
+    }
+    while (remaining < 0.5) {
+        filters.push('atempo=0.5');
+        remaining /= 0.5;
+    }
+    filters.push(`atempo=${remaining.toFixed(4)}`);
+    return filters.join(',');
+}
+// ─── Main Function ──────────────────────────────────────────────────
+export async function applyVoiceEffect(config) {
+    const { inputPath, outputPath, effect, intensity = 0.5 } = config;
+    assertExists(inputPath, 'Input file');
+    ensureDir(outputPath);
+    const clampedIntensity = Math.max(0, Math.min(1, intensity));
+    logger.info(`Applying voice effect: ${effect} (intensity: ${clampedIntensity})`);
+    const effectData = getEffectFilter(effect, clampedIntensity);
+    const hasVideo = await hasVideoStream(inputPath);
+    if (effectData.needsComplexPitch && effectData.pitchFactor) {
+        // Pitch shifting requires asetrate + atempo combination
+        const sampleRate = await getSampleRate(inputPath);
+        const factor = effectData.pitchFactor;
+        const newRate = Math.round(sampleRate * factor);
+        const tempoCompensation = 1 / factor;
+        const audioFilter = `asetrate=${newRate},${buildAtempoChain(tempoCompensation)},aresample=${sampleRate}`;
+        const args = ['-y', '-i', inputPath];
+        if (hasVideo) {
+            args.push('-af', audioFilter, '-c:v', 'copy', '-movflags', '+faststart');
+        }
+        else {
+            args.push('-af', audioFilter);
+        }
+        args.push(outputPath);
+        await runFfmpeg(args);
+    }
+    else {
+        // Standard filter-based effects
+        const args = ['-y', '-i', inputPath];
+        if (hasVideo) {
+            args.push('-af', effectData.filter, '-c:v', 'copy', '-movflags', '+faststart');
+        }
+        else {
+            args.push('-af', effectData.filter);
+        }
+        args.push(outputPath);
+        await runFfmpeg(args);
+    }
+    logger.info(`Voice effect applied: ${effect} → ${outputPath} (${fileInfo(outputPath)})`);
+    return outputPath;
+}
+//# sourceMappingURL=voice-effects.js.map

package/dist/tools/engine/voice-effects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-effects.js","sourceRoot":"","sources":["../../../src/tools/engine/voice-effects.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAwB7C,MAAM,CAAC,MAAM,iBAAiB,GAAkB;IAC9C,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO;IAC7C,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY;CAC9C,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAgC;IACpE,IAAI,EAAE,6CAA6C;IACnD,MAAM,EAAE,oCAAoC;IAC5C,IAAI,EAAE,+BAA+B;IACrC,QAAQ,EAAE,uCAAuC;IACjD,KAAK,EAAE,wCAAwC;IAC/C,OAAO,EAAE,8CAA8C;IACvD,KAAK,EAAE,yCAAyC;IAChD,SAAS,EAAE,oCAAoC;IAC/C,UAAU,EAAE,0CAA0C;CACvD,CAAC;AAEF,uEAAuE;AAEvE,SAAS,eAAe,CAAC,MAAmB,EAAE,SAAiB;IAC7D,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;IAE9C,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,uCAAuC;YACvC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAG,WAAW;YACtD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAG,YAAY;YACvD,MAAM,MAAM,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU;YACrD,MAAM,MAAM,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU;YACrD,OAAO,EAAE,MAAM,EAAE,iBAAiB,MAAM,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,EAAE,EAAE,CAAC;QAC7E,CAAC;QAED,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,0CAA0C;YAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY;YAChD,MAAM,MAAM,GAAa,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAa,EAAE,CAAC;YAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC/B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;gBACxC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;YACnD,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,iBAAiB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QAC7E,CAAC;QAED,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,yCAAyC;YACzC,qEAAqE;YACrE,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,aAAa;YAC7C,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;QACtE,CAAC;QAED,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,0CAA0C;YAC1C,kEAAkE;YAClE,MAAM,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,YAAY;YAC1C,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;QACtE,CAAC;QAED,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,8CAA8C;YAC9C,+DAA+D;YAC/D,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;gBACZ,OAAO,EAAE,MAAM,EAAE,0FAA0F,EAAE,CAAC;YAChH,CAAC;YACD,oCAAoC;YACpC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;YACrC,OAAO,EAAE,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC7E,CAAC;QAED,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;gBACZ,uCAAuC;gBACvC,OAAO,EAAE,MAAM,EAAE,mIAAmI,EAAE,CAAC;YACzJ,CAAC;YACD,gCAAgC;YAChC,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACvC,OAAO,EAAE,MAAM,EAAE,yCAAyC,GAAG,EAAE,EAAE,CAAC;QACpE,CAAC;QAED,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,wCAAwC;YACxC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAE,aAAa;YACxD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,eAAe;YAC5D,MAAM,KAAK,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,kBAAkB,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;YACtF,OAAO,EAAE,MAAM,EAAE,cAAc,MAAM,cAAc,OAAO,GAAG,KAAK,EAAE,EAAE,CAAC;QACzE,CAAC;QAED,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY;YACjD,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACvC,OAAO,EAAE,MAAM,EAAE,+CAA+C,IAAI,8CAA8C,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,GAAG,EAAE,EAAE,CAAC;QACjK,CAAC;QAED,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,2CAA2C;YAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,aAAa;YACvD,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACvC,MAAM,MAAM,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,0BAA0B,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1F,OAAO,EAAE,MAAM,EAAE,aAAa,MAAM,GAAG,MAAM,WAAW,GAAG,EAAE,EAAE,CAAC;QAClE,CAAC;QAED;YACE,MAAM,IAAI,KAAK,CAAC,yBAAyB,MAAM,EAAE,CAAC,CAAC;IACvD,CAAC;AACH,CAAC;AAED,uEAAuE;AAEvE,SAAS,SAAS,CAAC,IAAc,EAAE,SAAS,GAAG,OAAO;IACpD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YACvG,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,CAAC,KAAK,CAAC,kBAAkB,MAAM,EAAE,CAAC,CAAC;gBACzC,MAAM,CAAC,IAAI,KAAK,CAAC,kBAAkB,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBAC/D,OAAO;YACT,CAAC;YACD,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,UAAU,CAAC,IAAc;IAChC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,QAAQ,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;YAC3E,IAAI,KAAK,EAAE,CAAC;gBAAC,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBAAC,OAAO;YAAC,CAAC;YAC7E,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,SAAS,CAAC,QAAgB;IACjC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,YAAY,CAAC,QAAgB,EAAE,KAAK,GAAG,MAAM;IACpD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,eAAe,QAAQ,EAAE,CAAC,CAAC;AACnF,CAAC;AAED,SAAS,QAAQ,CAAC,QAAgB;IAChC,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACpC,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;AACvD,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,QAAgB;IAC5C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,iBAAiB,EAAE,GAAG,EAAE,eAAe,EAAE,mBAAmB,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC3I,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,KAAK,CAAC;IAAC,CAAC;AAC3B,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,QAAgB;IAC3C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC9I,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAClC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,KAAK,CAAC;IAAC,CAAC;AAC3B,CAAC;AAED,kEAAkE;AAClE,SAAS,gBAAgB,CAAC,KAAa;IACrC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,OAAO,SAAS,GAAG,GAAG,EAAE,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC3B,SAAS,IAAI,GAAG,CAAC;IACnB,CAAC;IACD,OAAO,SAAS,GAAG,GAAG,EAAE,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC3B,SAAS,IAAI,GAAG,CAAC;IACnB,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,UAAU,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/C,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED,uEAAuE;AAEvE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAyB;IAC9D,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,GAAG,GAAG,EAAE,GAAG,MAAM,CAAC;IAElE,YAAY,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IACtC,SAAS,CAAC,UAAU,CAAC,CAAC;IAEtB,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;IAC7D,MAAM,CAAC,IAAI,CAAC,0BAA0B,MAAM,gBAAgB,gBAAgB,GAAG,CAAC,CAAC;IAEjF,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,SAAS,CAAC,CAAC;IAEjD,IAAI,UAAU,CAAC,iBAAiB,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC;QAC3D,wDAAwD;QACxD,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,SAAS,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,MAAM,CAAC,CAAC;QAChD,MAAM,iBAAiB,GAAG,CAAC,GAAG,MAAM,CAAC;QAErC,MAAM,WAAW,GAAG,YAAY,OAAO,IAAI,gBAAgB,CAAC,iBAAiB,CAAC,cAAc,UAAU,EAAE,CAAC;QAEzG,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QACrC,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;QAC3E,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QAChC,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAEtB,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;SAAM,CAAC;QACN,gCAAgC;QAChC,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QACrC,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;QACjF,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;QACtC,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAEtB,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,yBAAyB,MAAM,MAAM,UAAU,KAAK,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACzF,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,32 @@
+export { recordWebsite } from './engine/index.js';
+export type { RecordingConfig, RecordingResult, Scene, ViewportPreset, EasingName } from './engine/index.js';
+export { addBackgroundMusic } from './engine/audio.js';
+export type { AddMusicConfig } from './engine/audio.js';
+export { concatenateVideos, generateIntro } from './engine/concat.js';
+export type { ConcatConfig, ConcatClip, IntroConfig, TransitionType } from './engine/concat.js';
+export { convertToSocialFormat, convertToAllFormats, SOCIAL_FORMATS } from './engine/social-format.js';
+export type { SocialFormat, CropStrategy, FormatConvertConfig } from './engine/social-format.js';
+export { addTextOverlays } from './engine/text-overlay.js';
+export type { TextOverlay, TextPosition } from './engine/text-overlay.js';
+export { generateSpeech, listElevenLabsVoices } from './engine/tts.js';
+export type { TTSConfig, TTSResult, TTSProvider, ElevenLabsVoice, OpenAIVoice } from './engine/tts.js';
+export { createNarratedVideo } from './engine/narrated-video.js';
+export type { NarratedVideoConfig, NarratedVideoResult, NarrationSegment } from './engine/narrated-video.js';
+export { adjustVideoSpeed, applyColorGrade, applyVideoEffect, cropVideo, reverseClip, extractAudio, burnSubtitles, autoCaption, addKeyframeAnimation, composePip, addAudioDucking, } from './engine/editing.js';
+export type { SpeedConfig, ColorGradeConfig, VideoEffect, EffectConfig, CropConfig, ReverseConfig, ExtractAudioConfig, BurnSubtitlesConfig, AutoCaptionConfig, AutoCaptionResult, Keyframe, KeyframeAnimationConfig, PipPosition, PipConfig, AudioDuckingConfig, } from './engine/editing.js';
+export { applyLutPreset, listLutPresets, ALL_LUT_PRESETS, PRESET_DESCRIPTIONS } from './engine/lut-presets.js';
+export type { LutPreset, LutPresetConfig } from './engine/lut-presets.js';
+export { applyVoiceEffect, ALL_VOICE_EFFECTS, VOICE_EFFECT_DESCRIPTIONS } from './engine/voice-effects.js';
+export type { VoiceEffect, VoiceEffectConfig } from './engine/voice-effects.js';
+export { applyChromaKey } from './engine/chroma-key.js';
+export type { ChromaKeyConfig } from './engine/chroma-key.js';
+export { syncToBeats } from './engine/beat-sync.js';
+export type { BeatSyncConfig, BeatSyncResult } from './engine/beat-sync.js';
+export { animateText, ALL_TEXT_ANIMATIONS, TEXT_ANIMATION_DESCRIPTIONS } from './engine/text-animations.js';
+export type { TextAnimation, TextAnimationConfig } from './engine/text-animations.js';
+export { mixAudioTracks } from './engine/audio-mixer.js';
+export type { AudioTrack, AudioMixConfig, AudioMixResult } from './engine/audio-mixer.js';
+export { listTemplates, getTemplate, getTemplateSummaries, getTemplateCategories } from './engine/templates.js';
+export type { VideoTemplate, TemplateCategory, TemplateSlot } from './engine/templates.js';
+export { renderTemplate } from './engine/template-renderer.js';
+export type { RenderTemplateConfig, RenderResult, TemplateAssets } from './engine/template-renderer.js';

package/dist/tools/index.js

@@ -0,0 +1,23 @@
+// Core recording
+export { recordWebsite } from './engine/index.js';
+// Post-production
+export { addBackgroundMusic } from './engine/audio.js';
+export { concatenateVideos, generateIntro } from './engine/concat.js';
+export { convertToSocialFormat, convertToAllFormats, SOCIAL_FORMATS } from './engine/social-format.js';
+export { addTextOverlays } from './engine/text-overlay.js';
+// TTS & Narration
+export { generateSpeech, listElevenLabsVoices } from './engine/tts.js';
+export { createNarratedVideo } from './engine/narrated-video.js';
+// Editing (NEW — CapCut-tier features)
+export { adjustVideoSpeed, applyColorGrade, applyVideoEffect, cropVideo, reverseClip, extractAudio, burnSubtitles, autoCaption, addKeyframeAnimation, composePip, addAudioDucking, } from './engine/editing.js';
+// CapCut-tier engines
+export { applyLutPreset, listLutPresets, ALL_LUT_PRESETS, PRESET_DESCRIPTIONS } from './engine/lut-presets.js';
+export { applyVoiceEffect, ALL_VOICE_EFFECTS, VOICE_EFFECT_DESCRIPTIONS } from './engine/voice-effects.js';
+export { applyChromaKey } from './engine/chroma-key.js';
+export { syncToBeats } from './engine/beat-sync.js';
+export { animateText, ALL_TEXT_ANIMATIONS, TEXT_ANIMATION_DESCRIPTIONS } from './engine/text-animations.js';
+export { mixAudioTracks } from './engine/audio-mixer.js';
+// Template engine
+export { listTemplates, getTemplate, getTemplateSummaries, getTemplateCategories } from './engine/templates.js';
+export { renderTemplate } from './engine/template-renderer.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGlD,kBAAkB;AAClB,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEtE,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEvG,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAG3D,kBAAkB;AAClB,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGjE,uCAAuC;AACvC,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,SAAS,EACT,WAAW,EACX,YAAY,EACZ,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,UAAU,EACV,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAe7B,sBAAsB;AACtB,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE/G,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAE3G,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAE5G,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGzD,kBAAkB;AAClB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEhH,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@studiomeyer/mcp-video",
+  "version": "1.0.0",
+  "description": "Cinema-grade video production MCP server — 8 tools for recording, editing, effects, captions, TTS, and smart screenshots. Zero-config, works with any MCP client.",
+  "type": "module",
+  "main": "dist/server.js",
+  "bin": {
+    "mcp-video": "./dist/server.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/server.js",
+    "dev": "tsx src/server.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "check": "node scripts/check-deps.js"
+  },
+  "keywords": [
+    "mcp",
+    "video",
+    "ffmpeg",
+    "recording",
+    "editing",
+    "tts",
+    "screenshot",
+    "playwright",
+    "model-context-protocol",
+    "ai",
+    "claude"
+  ],
+  "author": "StudioMeyer <hello@studiomeyer.io>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/studiomeyer-io/mcp-video.git"
+  },
+  "homepage": "https://github.com/studiomeyer-io/mcp-video",
+  "bugs": {
+    "url": "https://github.com/studiomeyer-io/mcp-video/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "playwright": "^1.50.0",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.6.0"
+  }
+}

package/scripts/check-deps.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+/**
+ * Check system dependencies for mcp-video
+ */
+
+import { execSync } from 'child_process';
+
+const deps = [
+  { name: 'ffmpeg', cmd: 'ffmpeg -version', required: true },
+  { name: 'ffprobe', cmd: 'ffprobe -version', required: true },
+  { name: 'playwright browsers', cmd: 'npx playwright install --dry-run', required: false },
+];
+
+let allOk = true;
+
+for (const dep of deps) {
+  try {
+    const output = execSync(dep.cmd, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
+    const version = output.split('\n')[0].trim();
+    console.log(`  ${dep.name}: ${version}`);
+  } catch {
+    if (dep.required) {
+      console.error(`  ${dep.name}: NOT FOUND (required)`);
+      allOk = false;
+    } else {
+      console.warn(`  ${dep.name}: not available (optional)`);
+    }
+  }
+}
+
+if (!allOk) {
+  console.error('\nMissing required dependencies. Install them:');
+  console.error('  Ubuntu/Debian: sudo apt install ffmpeg');
+  console.error('  macOS: brew install ffmpeg');
+  console.error('  Windows: choco install ffmpeg');
+  process.exit(1);
+}
+
+console.log('\nAll dependencies OK.');

package/src/handlers/capcut.ts

@@ -0,0 +1,245 @@
+/**
+ * CapCut-tier tool handlers — LUT Presets, Voice Effects, Chroma Key,
+ * Beat-Sync, Text Animations, Audio Mixer, Templates
+ */
+
+import { jsonResponse, type ToolHandler } from '../lib/types.js';
+import { logger } from '../lib/logger.js';
+import { applyLutPreset, listLutPresets } from '../tools/engine/lut-presets.js';
+import { applyVoiceEffect } from '../tools/engine/voice-effects.js';
+import { applyChromaKey } from '../tools/engine/chroma-key.js';
+import { syncToBeats } from '../tools/engine/beat-sync.js';
+import { animateText } from '../tools/engine/text-animations.js';
+import { mixAudioTracks } from '../tools/engine/audio-mixer.js';
+import { getTemplateSummaries, getTemplate } from '../tools/engine/templates.js';
+import { renderTemplate } from '../tools/engine/template-renderer.js';
+import type { LutPreset } from '../tools/engine/lut-presets.js';
+import type { VoiceEffect } from '../tools/engine/voice-effects.js';
+import type { TextAnimation, TextPosition } from '../tools/engine/text-animations.js';
+import type { AudioTrack } from '../tools/engine/audio-mixer.js';
+import type { TemplateCategory } from '../tools/engine/templates.js';
+
+export const capcutHandlers: Record<string, ToolHandler> = {
+
+  apply_lut_preset: async (args) => {
+    try {
+      const result = await applyLutPreset({
+        inputPath: args.inputPath,
+        outputPath: args.outputPath,
+        preset: args.preset as LutPreset,
+        intensity: args.intensity ?? 1.0,
+      });
+
+      const presets = listLutPresets();
+      const presetInfo = presets.find(p => p.name === args.preset);
+
+      return jsonResponse({
+        success: true,
+        outputPath: result,
+        preset: args.preset,
+        intensity: args.intensity ?? 1.0,
+        description: presetInfo?.description ?? '',
+        message: `Applied "${args.preset}" color grade (intensity: ${args.intensity ?? 1.0}).`,
+        availablePresets: presets.length,
+      });
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : String(error);
+      logger.error(`apply_lut_preset failed: ${msg}`);
+      return jsonResponse({ success: false, error: msg }, true);
+    }
+  },
+
+  apply_voice_effect: async (args) => {
+    try {
+      const result = await applyVoiceEffect({
+        inputPath: args.inputPath,
+        outputPath: args.outputPath,
+        effect: args.effect as VoiceEffect,
+        intensity: args.intensity ?? 0.5,
+      });
+
+      return jsonResponse({
+        success: true,
+        outputPath: result,
+        effect: args.effect,
+        intensity: args.intensity ?? 0.5,
+        message: `Applied "${args.effect}" voice effect (intensity: ${args.intensity ?? 0.5}).`,
+      });
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : String(error);
+      logger.error(`apply_voice_effect failed: ${msg}`);
+      return jsonResponse({ success: false, error: msg }, true);
+    }
+  },
+
+  apply_chroma_key: async (args) => {
+    try {
+      const result = await applyChromaKey({
+        inputPath: args.inputPath,
+        outputPath: args.outputPath,
+        background: args.background,
+        keyColor: args.keyColor ?? '00FF00',
+        similarity: args.similarity ?? 0.15,
+        blend: args.blend ?? 0.02,
+        despill: args.despill ?? true,
+        useColorkey: args.useColorkey ?? false,
+      });
+
+      return jsonResponse({
+        success: true,
+        outputPath: result,
+        keyColor: args.keyColor ?? '00FF00',
+        similarity: args.similarity ?? 0.15,
+        blend: args.blend ?? 0.02,
+        despill: args.despill ?? true,
+        mode: args.useColorkey ? 'colorkey (RGB)' : 'chromakey (YUV)',
+        message: `Chroma key applied — background replaced. Key color: #${args.keyColor ?? '00FF00'}.`,
+      });
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : String(error);
+      logger.error(`apply_chroma_key failed: ${msg}`);
+      return jsonResponse({ success: false, error: msg }, true);
+    }
+  },
+
+  sync_to_beat: async (args) => {
+    try {
+      const result = await syncToBeats({
+        audioPath: args.audioPath,
+        clips: args.clips as string[],
+        outputPath: args.outputPath,
+        beatEffect: args.beatEffect ?? 'cut',
+        sensitivity: args.sensitivity ?? 0.6,
+        minBeatInterval: args.minBeatInterval ?? 0.3,
+        maxBeats: args.maxBeats ?? 50,
+      });
+
+      return jsonResponse({
+        success: true,
+        outputPath: result.outputPath,
+        beatsDetected: result.beatsDetected,
+        beatsUsed: result.beatsUsed,
+        duration: result.duration,
+        beatPositions: result.beatPositions.slice(0, 20), // First 20 for readability
+        message: `Beat-synced video: ${result.beatsUsed} cuts synced to ${result.beatsDetected} detected beats (${result.duration.toFixed(1)}s).`,
+      });
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : String(error);
+      logger.error(`sync_to_beat failed: ${msg}`);
+      return jsonResponse({ success: false, error: msg }, true);
+    }
+  },
+
+  animate_text: async (args) => {
+    try {
+      const result = await animateText({
+        inputPath: args.inputPath,
+        outputPath: args.outputPath,
+        text: args.text,
+        animation: args.animation as TextAnimation,
+        startTime: args.startTime ?? 0,
+        duration: args.duration ?? 3,
+        fontSize: args.fontSize ?? 48,
+        fontColor: args.fontColor ?? 'FFFFFF',
+        position: (args.position as TextPosition) ?? 'center',
+        shadow: args.shadow ?? true,
+      });
+
+      return jsonResponse({
+        success: true,
+        outputPath: result,
+        animation: args.animation,
+        text: args.text,
+        startTime: args.startTime ?? 0,
+        duration: args.duration ?? 3,
+        message: `Animated text "${(args.text as string).substring(0, 30)}..." with ${args.animation} effect.`,
+      });
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : String(error);
+      logger.error(`animate_text failed: ${msg}`);
+      return jsonResponse({ success: false, error: msg }, true);
+    }
+  },
+
+  mix_audio_tracks: async (args) => {
+    try {
+      const result = await mixAudioTracks({
+        tracks: args.tracks as AudioTrack[],
+        outputPath: args.outputPath,
+        autoDuck: args.autoDuck ?? false,
+        duckLevel: args.duckLevel ?? 0.2,
+        format: args.format ?? 'aac',
+        duration: args.duration,
+      });
+
+      return jsonResponse({
+        success: true,
+        outputPath: result.outputPath,
+        trackCount: result.trackCount,
+        ducking: result.ducking,
+        format: args.format ?? 'aac',
+        message: `Mixed ${result.trackCount} audio tracks${result.ducking ? ' with auto-ducking' : ''}.`,
+      });
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : String(error);
+      logger.error(`mix_audio_tracks failed: ${msg}`);
+      return jsonResponse({ success: false, error: msg }, true);
+    }
+  },
+
+  list_video_templates: async (args) => {
+    try {
+      const category = args.category as TemplateCategory | undefined;
+      const summaries = getTemplateSummaries(category);
+
+      return jsonResponse({
+        success: true,
+        templates: summaries,
+        count: summaries.length,
+        categories: ['social-reel', 'product-demo', 'testimonial', 'before-after', 'slideshow', 'tutorial', 'announcement', 'promo'],
+        message: `Found ${summaries.length} templates${category ? ` in category "${category}"` : ''}.`,
+      });
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : String(error);
+      logger.error(`list_video_templates failed: ${msg}`);
+      return jsonResponse({ success: false, error: msg }, true);
+    }
+  },
+
+  render_template: async (args) => {
+    try {
+      const result = await renderTemplate({
+        templateId: args.templateId,
+        outputPath: args.outputPath,
+        assets: {
+          clips: args.clips as Record<string, string>,
+          texts: args.texts as Record<string, string> | undefined,
+          musicPath: args.musicPath as string | undefined,
+          musicVolume: args.musicVolume as number | undefined,
+        },
+        colorGrade: args.colorGrade as string | undefined,
+        socialFormats: args.socialFormats ?? false,
+      });
+
+      // Get template details for the response
+      const template = getTemplate(args.templateId);
+
+      return jsonResponse({
+        success: true,
+        outputPath: result.outputPath,
+        template: result.template,
+        templateName: template?.name ?? result.template,
+        duration: `${result.duration}s`,
+        resolution: `${result.resolution.width}x${result.resolution.height}`,
+        clipsUsed: result.clipsUsed,
+        textsApplied: result.textsApplied,
+        socialVariants: result.socialVariants,
+        message: `Rendered "${template?.name ?? result.template}": ${result.clipsUsed} clips, ${result.textsApplied} text animations, ${result.duration}s.`,
+      });
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : String(error);
+      logger.error(`render_template failed: ${msg}`);
+      return jsonResponse({ success: false, error: msg }, true);
+    }
+  },
+};