@studiomeyer/mcp-video 1.0.0

package/dist/lib/dual-transport.js

@@ -0,0 +1,208 @@
+/**
+ * Dual Transport for MCP Servers — Stdio + Streamable HTTP
+ *
+ * Default: stdio (backward compatible, used by Claude Code via subprocess)
+ * --http: Streamable HTTP on configurable port (persistent HTTP microservice)
+ *
+ * Usage:
+ *   startDualTransport(createMcpServer, { serverName, serverVersion, defaultPort })
+ *
+ * HTTP mode flags:
+ *   --http           Enable HTTP transport
+ *   --port=XXXX      Override default port
+ *   MCP_HTTP=1       Enable via env var
+ *   MCP_PORT=XXXX    Override port via env var
+ */
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { createServer as createHttpServer } from 'node:http';
+import { randomUUID } from 'node:crypto';
+import { logger } from './logger.js';
+// ─── Detection ───────────────────────────────────────
+function isHttpMode() {
+    return (process.argv.includes('--http') ||
+        process.env.MCP_HTTP === '1' ||
+        process.env.MCP_HTTP === 'true');
+}
+function getPort(defaultPort) {
+    const portArg = process.argv.find((a) => a.startsWith('--port='));
+    if (portArg) {
+        const parsed = parseInt(portArg.split('=')[1], 10);
+        if (!isNaN(parsed))
+            return parsed;
+    }
+    if (process.env.MCP_PORT) {
+        const parsed = parseInt(process.env.MCP_PORT, 10);
+        if (!isNaN(parsed))
+            return parsed;
+    }
+    return defaultPort;
+}
+// ─── Main Entry ──────────────────────────────────────
+/**
+ * Start an MCP server with dual transport support.
+ *
+ * @param createServer - Factory that creates a fresh MCP server (McpServer or Server)
+ * @param options - Server name, version, and default HTTP port
+ *
+ * For stdio: creates one server, connects to StdioServerTransport.
+ * For HTTP: creates a new server per session, connects to StreamableHTTPServerTransport.
+ */
+export async function startDualTransport(createServer, options) {
+    if (isHttpMode()) {
+        return startHttpTransport(createServer, options);
+    }
+    return startStdioTransport(createServer, options);
+}
+// ─── Stdio Transport ─────────────────────────────────
+async function startStdioTransport(createServer, options) {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logger.info(`${options.serverName} v${options.serverVersion} started (stdio)`);
+    return { type: 'stdio' };
+}
+async function startHttpTransport(createServer, options) {
+    const port = getPort(options.defaultPort);
+    const sessions = new Map();
+    const httpServer = createHttpServer(async (req, res) => {
+        try {
+            await handleHttpRequest(req, res, sessions, createServer, options);
+        }
+        catch (err) {
+            logger.logError('HTTP request error', err);
+            if (!res.headersSent) {
+                res.writeHead(500, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ error: 'Internal server error' }));
+            }
+        }
+    });
+    const host = process.env.MCP_HOST || '127.0.0.1';
+    httpServer.listen(port, host, () => {
+        logger.info(`${options.serverName} v${options.serverVersion} started (HTTP on ${host}:${port})`);
+    });
+    // Session cleanup: remove stale sessions older than 30 minutes
+    const cleanupInterval = setInterval(() => {
+        const now = Date.now();
+        const staleThreshold = 30 * 60 * 1000;
+        for (const [sid, session] of sessions) {
+            if (now - session.createdAt > staleThreshold) {
+                session.transport.close();
+                sessions.delete(sid);
+                logger.info(`Session expired: ${sid.slice(0, 8)}...`);
+            }
+        }
+    }, 60_000);
+    // Graceful shutdown
+    const shutdown = () => {
+        logger.info('Shutting down HTTP transport...');
+        clearInterval(cleanupInterval);
+        for (const [, session] of sessions) {
+            session.transport.close();
+        }
+        httpServer.close();
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+    return { type: 'http', port };
+}
+// ─── Request Handler ─────────────────────────────────
+async function handleHttpRequest(req, res, sessions, createServer, options) {
+    // CORS headers
+    res.setHeader('Access-Control-Allow-Origin', '*');
+    res.setHeader('Access-Control-Allow-Methods', 'GET, POST, DELETE, OPTIONS');
+    res.setHeader('Access-Control-Allow-Headers', 'Content-Type, MCP-Session-ID');
+    res.setHeader('Access-Control-Expose-Headers', 'MCP-Session-ID');
+    if (req.method === 'OPTIONS') {
+        res.writeHead(204);
+        res.end();
+        return;
+    }
+    // Health check endpoint
+    if (req.url === '/health') {
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({
+            status: 'ok',
+            server: options.serverName,
+            version: options.serverVersion,
+            transport: 'streamable-http',
+            sessions: sessions.size,
+        }));
+        return;
+    }
+    // MCP endpoint
+    if (req.url === '/mcp') {
+        const sessionId = req.headers['mcp-session-id'];
+        if (req.method === 'POST') {
+            const body = await parseBody(req);
+            if (sessionId && sessions.has(sessionId)) {
+                await sessions.get(sessionId).transport.handleRequest(req, res, body);
+            }
+            else if (!sessionId) {
+                const mcpServer = createServer();
+                const transport = new StreamableHTTPServerTransport({
+                    sessionIdGenerator: () => randomUUID(),
+                    onsessioninitialized: (sid) => {
+                        sessions.set(sid, { transport, createdAt: Date.now() });
+                        logger.info(`Session created: ${sid.slice(0, 8)}... (${sessions.size} active)`);
+                    },
+                    onsessionclosed: (sid) => {
+                        sessions.delete(sid);
+                        logger.info(`Session closed: ${sid.slice(0, 8)}... (${sessions.size} active)`);
+                    },
+                });
+                await mcpServer.connect(transport);
+                await transport.handleRequest(req, res, body);
+            }
+            else {
+                res.writeHead(404, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ error: 'Session not found', code: 'SESSION_NOT_FOUND' }));
+            }
+            return;
+        }
+        if (req.method === 'GET') {
+            if (sessionId && sessions.has(sessionId)) {
+                await sessions.get(sessionId).transport.handleRequest(req, res);
+            }
+            else {
+                res.writeHead(400, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ error: 'Invalid or missing session ID', code: 'INVALID_SESSION' }));
+            }
+            return;
+        }
+        if (req.method === 'DELETE') {
+            if (sessionId && sessions.has(sessionId)) {
+                const session = sessions.get(sessionId);
+                await session.transport.handleRequest(req, res);
+                sessions.delete(sessionId);
+            }
+            else {
+                res.writeHead(404, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ error: 'Session not found', code: 'SESSION_NOT_FOUND' }));
+            }
+            return;
+        }
+    }
+    // 404 for anything else
+    res.writeHead(404, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({ error: 'Not found', code: 'NOT_FOUND' }));
+}
+// ─── Body Parser ─────────────────────────────────────
+function parseBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on('data', (chunk) => chunks.push(chunk));
+        req.on('end', () => {
+            const body = Buffer.concat(chunks).toString('utf-8');
+            try {
+                resolve(body ? JSON.parse(body) : undefined);
+            }
+            catch {
+                resolve(undefined);
+            }
+        });
+        req.on('error', reject);
+    });
+}
+//# sourceMappingURL=dual-transport.js.map

package/dist/lib/dual-transport.js.map

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

package/dist/lib/logger.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Structured logging for mcp-video
+ * Logs to stderr to not interfere with MCP protocol on stdout
+ */
+export declare const logger: {
+    debug: (message: string, context?: Record<string, unknown>) => void;
+    info: (message: string, context?: Record<string, unknown>) => void;
+    warn: (message: string, context?: Record<string, unknown>) => void;
+    error: (message: string, context?: Record<string, unknown>) => void;
+    logError: (message: string, error: unknown, context?: Record<string, unknown>) => void;
+};
+export type Logger = typeof logger;

package/dist/lib/logger.js

@@ -0,0 +1,42 @@
+/**
+ * Structured logging for mcp-video
+ * Logs to stderr to not interfere with MCP protocol on stdout
+ */
+const DEBUG = process.env.DEBUG?.includes('mcp-video') || process.env.MCP_VIDEO_DEBUG === '1';
+function formatEntry(entry) {
+    const prefix = `[${entry.timestamp}] [${entry.level.toUpperCase()}]`;
+    const ctx = entry.context ? ` ${JSON.stringify(entry.context)}` : '';
+    return `${prefix} ${entry.message}${ctx}`;
+}
+function log(level, message, context) {
+    if (level === 'debug' && !DEBUG)
+        return;
+    const entry = {
+        level,
+        message,
+        context,
+        timestamp: new Date().toISOString(),
+    };
+    console.error(formatEntry(entry));
+}
+export const logger = {
+    debug: (message, context) => log('debug', message, context),
+    info: (message, context) => log('info', message, context),
+    warn: (message, context) => log('warn', message, context),
+    error: (message, context) => log('error', message, context),
+    logError: (message, error, context) => {
+        const errorContext = { ...context };
+        if (error instanceof Error) {
+            errorContext.errorMessage = error.message;
+            errorContext.errorName = error.name;
+            if (DEBUG && error.stack) {
+                errorContext.stack = error.stack;
+            }
+        }
+        else {
+            errorContext.error = String(error);
+        }
+        log('error', message, errorContext);
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/lib/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/lib/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,GAAG,CAAC;AAE9F,SAAS,WAAW,CAAC,KAAe;IAClC,MAAM,MAAM,GAAG,IAAI,KAAK,CAAC,SAAS,MAAM,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,CAAC;IACrE,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACrE,OAAO,GAAG,MAAM,IAAI,KAAK,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC;AAC5C,CAAC;AAED,SAAS,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,OAAiC;IAC9E,IAAI,KAAK,KAAK,OAAO,IAAI,CAAC,KAAK;QAAE,OAAO;IAExC,MAAM,KAAK,GAAa;QACtB,KAAK;QACL,OAAO;QACP,OAAO;QACP,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;IAEF,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,EAAE,CAAC,OAAe,EAAE,OAAiC,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAC7F,IAAI,EAAE,CAAC,OAAe,EAAE,OAAiC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC;IAC3F,IAAI,EAAE,CAAC,OAAe,EAAE,OAAiC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC;IAC3F,KAAK,EAAE,CAAC,OAAe,EAAE,OAAiC,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAE7F,QAAQ,EAAE,CAAC,OAAe,EAAE,KAAc,EAAE,OAAiC,EAAE,EAAE;QAC/E,MAAM,YAAY,GAA4B,EAAE,GAAG,OAAO,EAAE,CAAC;QAE7D,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,YAAY,CAAC,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC;YAC1C,YAAY,CAAC,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC;YACpC,IAAI,KAAK,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBACzB,YAAY,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;YACnC,CAAC;QACH,CAAC;aAAM,CAAC;YACN,YAAY,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC;QAED,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;IACtC,CAAC;CACF,CAAC"}

package/dist/lib/types.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Shared types for MCP tool handlers
+ */
+export interface ToolResponse {
+    [key: string]: unknown;
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError?: boolean;
+}
+export type ToolHandler = (args: any) => ToolResponse | Promise<ToolResponse>;
+/** Helper to wrap a JSON result into a ToolResponse */
+export declare function jsonResponse(result: unknown, isError?: boolean): ToolResponse;
+/** Helper to create an error ToolResponse with structured error code */
+export declare function errorResponse(message: string, code?: string): ToolResponse;

package/dist/lib/types.js

@@ -0,0 +1,15 @@
+/**
+ * Shared types for MCP tool handlers
+ */
+/** Helper to wrap a JSON result into a ToolResponse */
+export function jsonResponse(result, isError) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+        ...(isError !== undefined ? { isError } : {}),
+    };
+}
+/** Helper to create an error ToolResponse with structured error code */
+export function errorResponse(message, code) {
+    return jsonResponse({ error: message, code: code ?? 'INTERNAL_ERROR' }, true);
+}
+//# sourceMappingURL=types.js.map

package/dist/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,uDAAuD;AACvD,MAAM,UAAU,YAAY,CAAC,MAAe,EAAE,OAAiB;IAC7D,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QAClE,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9C,CAAC;AACJ,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,IAAa;IAC1D,OAAO,YAAY,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,IAAI,gBAAgB,EAAE,EAAE,IAAI,CAAC,CAAC;AAChF,CAAC"}