@studiomeyer/mcp-video 1.0.0

package/dist/schemas/video.d.ts

@@ -0,0 +1,236 @@
+/**
+ * MCP Tool Schemas for Cinema Video Engine
+ */
+export declare const videoSchemas: ({
+    name: string;
+    description: string;
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+    };
+    inputSchema: {
+        type: "object";
+        properties: {
+            url: {
+                type: string;
+                description: string;
+            };
+            outputPath: {
+                type: string;
+                description: string;
+            };
+            viewport: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            fps: {
+                type: string;
+                description: string;
+            };
+            scenes: {
+                type: string;
+                items: {
+                    type: "object";
+                    properties: {
+                        type: {
+                            type: string;
+                            enum: string[];
+                            description: string;
+                        };
+                        to: {
+                            type: string[];
+                            description: string;
+                        };
+                        duration: {
+                            type: string;
+                            description: string;
+                        };
+                        easing: {
+                            type: string;
+                            enum: string[];
+                            description: string;
+                        };
+                        selector: {
+                            type: string;
+                            description: string;
+                        };
+                        text: {
+                            type: string;
+                            description: string;
+                        };
+                        delay: {
+                            type: string;
+                            description: string;
+                        };
+                        waitFor: {
+                            type: string[];
+                            description: string;
+                        };
+                        pauseAfter: {
+                            type: string;
+                            description: string;
+                        };
+                        animateCursor: {
+                            type: string;
+                            description: string;
+                        };
+                        timeout: {
+                            type: string;
+                            description: string;
+                        };
+                    };
+                    required: string[];
+                };
+                description: string;
+            };
+            cursor: {
+                type: string;
+                properties: {
+                    enabled: {
+                        type: string;
+                        description: string;
+                    };
+                    style: {
+                        type: string;
+                        enum: string[];
+                        description: string;
+                    };
+                    color: {
+                        type: string;
+                        description: string;
+                    };
+                    size: {
+                        type: string;
+                        description: string;
+                    };
+                };
+                description: string;
+            };
+            codec: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            quality: {
+                type: string;
+                description: string;
+            };
+            darkMode: {
+                type: string;
+                description: string;
+            };
+            preloadContent: {
+                type: string;
+                description: string;
+            };
+            dismissOverlays: {
+                type: string;
+                description: string;
+            };
+            duration?: undefined;
+            easing?: undefined;
+            devices?: undefined;
+            outputDir?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+    };
+    inputSchema: {
+        type: "object";
+        properties: {
+            url: {
+                type: string;
+                description: string;
+            };
+            duration: {
+                type: string;
+                description: string;
+            };
+            viewport: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            easing: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            outputPath: {
+                type: string;
+                description: string;
+            };
+            fps?: undefined;
+            scenes?: undefined;
+            cursor?: undefined;
+            codec?: undefined;
+            quality?: undefined;
+            darkMode?: undefined;
+            preloadContent?: undefined;
+            dismissOverlays?: undefined;
+            devices?: undefined;
+            outputDir?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+    };
+    inputSchema: {
+        type: "object";
+        properties: {
+            url: {
+                type: string;
+                description: string;
+            };
+            devices: {
+                type: string;
+                items: {
+                    type: string;
+                    enum: string[];
+                };
+                description: string;
+            };
+            duration: {
+                type: string;
+                description: string;
+            };
+            outputDir: {
+                type: string;
+                description: string;
+            };
+            outputPath?: undefined;
+            viewport?: undefined;
+            fps?: undefined;
+            scenes?: undefined;
+            cursor?: undefined;
+            codec?: undefined;
+            quality?: undefined;
+            darkMode?: undefined;
+            preloadContent?: undefined;
+            dismissOverlays?: undefined;
+            easing?: undefined;
+        };
+        required: string[];
+    };
+})[];

package/dist/schemas/video.js

@@ -0,0 +1,210 @@
+/**
+ * MCP Tool Schemas for Cinema Video Engine
+ */
+const sceneSchema = {
+    type: 'object',
+    properties: {
+        type: {
+            type: 'string',
+            enum: ['scroll', 'pause', 'hover', 'click', 'type', 'wait'],
+            description: 'Scene type',
+        },
+        to: {
+            type: ['string', 'number'],
+            description: '[scroll] Target: "bottom", "top", pixel number, or CSS selector',
+        },
+        duration: {
+            type: 'number',
+            description: '[scroll/pause/hover] Duration in seconds',
+        },
+        easing: {
+            type: 'string',
+            enum: [
+                'linear', 'easeInQuad', 'easeOutQuad', 'easeInOutQuad',
+                'easeInCubic', 'easeOutCubic', 'easeInOutCubic',
+                'easeInQuart', 'easeOutQuart', 'easeInOutQuart',
+                'easeInQuint', 'easeOutQuint', 'easeInOutQuint',
+                'easeInOutSine', 'cinematic', 'showcase',
+            ],
+            description: '[scroll] Easing curve (default: easeInOutCubic). "showcase" = dramatic slow start/end, "cinematic" = cruise-style',
+        },
+        selector: {
+            type: 'string',
+            description: '[hover/click/type/wait] CSS selector',
+        },
+        text: {
+            type: 'string',
+            description: '[type] Text to type',
+        },
+        delay: {
+            type: 'number',
+            description: '[type] Delay between keystrokes in ms (default: 80)',
+        },
+        waitFor: {
+            type: ['string', 'number'],
+            description: '[click] Wait strategy: "networkidle", "load", or milliseconds',
+        },
+        pauseAfter: {
+            type: 'number',
+            description: '[click] Pause after click in seconds (default: 1)',
+        },
+        animateCursor: {
+            type: 'boolean',
+            description: '[hover] Animate cursor movement (default: true)',
+        },
+        timeout: {
+            type: 'number',
+            description: '[wait] Max wait time in ms (default: 5000)',
+        },
+    },
+    required: ['type'],
+};
+export const videoSchemas = [
+    {
+        name: 'record_website_video',
+        description: `Record a cinema-quality video of a website with buttery-smooth 60fps scrolling. Uses frame-by-frame capture (not real-time screen recording) for perfect quality with zero frame drops. Supports custom scenes (scroll, hover, click, pause), multiple viewports (desktop/mobile/4K), cinematic easing curves, and visible cursor simulation. Output: MP4 + thumbnail PNG. Output directory: ./output/ (configurable via VIDEO_OUTPUT_DIR env var).`,
+        annotations: {
+            title: 'Record Website Video',
+            readOnlyHint: false,
+            destructiveHint: false,
+            openWorldHint: true,
+            idempotentHint: true,
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                url: {
+                    type: 'string',
+                    description: 'URL of the website to record',
+                },
+                outputPath: {
+                    type: 'string',
+                    description: 'Output file path without extension (default: ./output/website-video-{timestamp})',
+                },
+                viewport: {
+                    type: 'string',
+                    enum: ['desktop', 'desktop-4k', 'tablet', 'tablet-landscape', 'mobile', 'mobile-landscape'],
+                    description: 'Viewport preset (default: desktop = 1920x1080)',
+                },
+                fps: {
+                    type: 'number',
+                    description: 'Frames per second (default: 60). Use 30 for smaller files.',
+                },
+                scenes: {
+                    type: 'array',
+                    items: sceneSchema,
+                    description: 'Array of scene definitions. If empty, does a default full-page scroll with pause at top/bottom.',
+                },
+                cursor: {
+                    type: 'object',
+                    properties: {
+                        enabled: { type: 'boolean', description: 'Show visible cursor (default: true)' },
+                        style: { type: 'string', enum: ['dot', 'arrow', 'pointer'], description: 'Cursor style (default: dot)' },
+                        color: { type: 'string', description: 'Cursor color (default: rgba(255,255,255,0.9))' },
+                        size: { type: 'number', description: 'Cursor size in px (default: 20)' },
+                    },
+                    description: 'Cursor configuration',
+                },
+                codec: {
+                    type: 'string',
+                    enum: ['h264', 'h265', 'vp9'],
+                    description: 'Video codec (default: h264). h265 = smaller files, vp9 = WebM format.',
+                },
+                quality: {
+                    type: 'number',
+                    description: 'CRF quality (0=lossless, 51=worst, default: 18). Lower = better quality, bigger file.',
+                },
+                darkMode: {
+                    type: 'boolean',
+                    description: 'Enable dark mode (default: false)',
+                },
+                preloadContent: {
+                    type: 'boolean',
+                    description: 'Pre-scroll to trigger lazy loading (default: true)',
+                },
+                dismissOverlays: {
+                    type: 'boolean',
+                    description: 'Auto-dismiss cookie banners and popups (default: true)',
+                },
+            },
+            required: ['url'],
+        },
+    },
+    {
+        name: 'record_website_scroll',
+        description: 'Quick scroll-through video of a website. Simplified version of record_website_video — just provide URL and get a smooth 60fps scroll video. Perfect for quick portfolio showcases.',
+        annotations: {
+            title: 'Record Website Scroll',
+            readOnlyHint: false,
+            destructiveHint: false,
+            openWorldHint: true,
+            idempotentHint: true,
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                url: {
+                    type: 'string',
+                    description: 'URL of the website to record',
+                },
+                duration: {
+                    type: 'number',
+                    description: 'Scroll duration in seconds (default: 12)',
+                },
+                viewport: {
+                    type: 'string',
+                    enum: ['desktop', 'desktop-4k', 'tablet', 'mobile'],
+                    description: 'Viewport preset (default: desktop)',
+                },
+                easing: {
+                    type: 'string',
+                    enum: ['easeInOutCubic', 'easeInOutQuint', 'easeInOutSine', 'cinematic', 'showcase'],
+                    description: 'Scroll easing curve (default: showcase)',
+                },
+                outputPath: {
+                    type: 'string',
+                    description: 'Output file path (default: ./output/scroll-{domain}-{timestamp})',
+                },
+            },
+            required: ['url'],
+        },
+    },
+    {
+        name: 'record_multi_device',
+        description: 'Record the same website in multiple viewports (desktop + tablet + mobile) in one go. Creates separate video files for each device. Great for responsive design showcases.',
+        annotations: {
+            title: 'Record Multi-Device Video',
+            readOnlyHint: false,
+            destructiveHint: false,
+            openWorldHint: true,
+            idempotentHint: true,
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                url: {
+                    type: 'string',
+                    description: 'URL of the website to record',
+                },
+                devices: {
+                    type: 'array',
+                    items: {
+                        type: 'string',
+                        enum: ['desktop', 'desktop-4k', 'tablet', 'tablet-landscape', 'mobile', 'mobile-landscape'],
+                    },
+                    description: 'Device viewports to record (default: ["desktop", "tablet", "mobile"])',
+                },
+                duration: {
+                    type: 'number',
+                    description: 'Scroll duration per device in seconds (default: 10)',
+                },
+                outputDir: {
+                    type: 'string',
+                    description: 'Output directory (default: ./output/)',
+                },
+            },
+            required: ['url'],
+        },
+    },
+];
+//# sourceMappingURL=video.js.map

package/dist/schemas/video.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"video.js","sourceRoot":"","sources":["../../src/schemas/video.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * Video Production — MCP Server v1.0.0
+ *
+ * 8 consolidated tools (from 33+) for recording, editing, color grading,
+ * audio, text, compositing, speech/narration, and smart screenshots.
+ *
+ * Port: 9847 (HTTP mode, configurable via MCP_PORT)
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function createMcpServer(): McpServer;