luma-mcp 1.0.2 → 1.1.0

package/mcp-server/build/index.js

@@ -1,160 +0,0 @@
-#!/usr/bin/env node
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { configurationService } from './core/environment.js';
-import { handleError } from './core/error-handler.js';
-import { setupConsoleRedirection } from './utils/logger.js';
-// Setup console redirection BEFORE any other code to prevent stdout pollution
-setupConsoleRedirection();
-// Import tool registration functions
-import { registerImageAnalysisTool } from './tools/image-analysis.js';
-import { registerVideoAnalysisTool } from './tools/video-analysis.js';
-import { McpError } from "./types/index.js";
-/**
- * MCP Server Application class
- */
-class McpServerApplication {
-    server;
-    constructor() {
-        this.server = new McpServer({
-            name: configurationService.getServerConfig().name,
-            version: configurationService.getServerConfig().version
-        }, {
-            capabilities: {
-                tools: {}
-            }
-        });
-        this.setupErrorHandling();
-        console.info('MCP Server Application initialized');
-    }
-    /**
-     * Register all tools
-     */
-    async registerTools() {
-        try {
-            // Register tools directly with server
-            registerImageAnalysisTool(this.server);
-            registerVideoAnalysisTool(this.server);
-            console.info('Successfully registered all tools');
-        }
-        catch (error) {
-            const standardError = await handleError(error, {
-                operation: 'tool-registration',
-                metadata: { component: 'McpServerApplication' }
-            });
-            console.error('Failed to register tools', standardError);
-            throw standardError;
-        }
-    }
-    /**
-     * Setup error handling
-     */
-    setupErrorHandling() {
-        process.on('uncaughtException', (error) => {
-            console.error('Uncaught exception:', error);
-            this.gracefulShutdown(1);
-        });
-        process.on('unhandledRejection', (reason, promise) => {
-            console.error('Unhandled rejection at:', { promise, reason });
-            this.gracefulShutdown(1);
-        });
-        process.on('SIGINT', () => {
-            console.info('Received SIGINT, shutting down gracefully...');
-            this.gracefulShutdown(0);
-        });
-        process.on('SIGTERM', () => {
-            console.info('Received SIGTERM, shutting down gracefully...');
-            this.gracefulShutdown(0);
-        });
-    }
-    /**
-     * Graceful shutdown
-     */
-    gracefulShutdown(exitCode) {
-        try {
-            console.info('Performing graceful shutdown...');
-            // Cleanup logic can be added here
-            process.exit(exitCode);
-        }
-        catch (error) {
-            console.error('Error during graceful shutdown:', { error });
-            process.exit(1);
-        }
-    }
-    /**
-     * Start server
-     */
-    async start() {
-        try {
-            console.info('Starting MCP server...');
-            // Set up global error handling
-            process.on('uncaughtException', async (error) => {
-                const standardError = await handleError(error, {
-                    operation: 'uncaughtException',
-                    metadata: { source: 'process' }
-                });
-                console.error('Uncaught exception:', standardError);
-                process.exit(1);
-            });
-            process.on('unhandledRejection', async (reason) => {
-                const error = reason instanceof Error ? reason : new Error(String(reason));
-                const standardError = await handleError(error, {
-                    operation: 'unhandledRejection',
-                    metadata: { source: 'process' }
-                });
-                console.error('Unhandled Promise rejection:', standardError);
-                process.exit(1);
-            });
-            // Register tools
-            await this.registerTools();
-            // Create transport layer
-            const transport = new StdioServerTransport();
-            // Start server
-            await this.server.connect(transport);
-            console.info('MCP Server started successfully', {
-                mode: configurationService.getPlatformModel(),
-                name: configurationService.getServerConfig().name,
-                version: configurationService.getServerConfig().version
-            });
-        }
-        catch (error) {
-            const standardError = await handleError(error, {
-                operation: 'server-start',
-                metadata: { component: 'McpServerApplication' }
-            });
-            console.error('Server startup failed:', standardError);
-            throw standardError;
-        }
-    }
-    /**
-     * Gracefully shutdown server
-     */
-    async shutdown() {
-        try {
-            console.info('Shutting down MCP server...');
-            console.info('MCP server shutdown completed');
-        }
-        catch (error) {
-            console.error('Error during server shutdown', { error });
-            throw error;
-        }
-    }
-}
-// Start application
-async function main() {
-    try {
-        const app = new McpServerApplication();
-        await app.start();
-    }
-    catch (error) {
-        if (error instanceof McpError) {
-            console.error('Application startup failed:', { message: error.message });
-        }
-        else {
-            console.error('Application startup failed:', { error });
-        }
-        process.exit(1);
-    }
-}
-// Start main program
-main();

package/mcp-server/build/tools/image-analysis.js

@@ -1,125 +0,0 @@
-import { z } from 'zod';
-import { FileNotFoundError, ApiError } from '../types/index.js';
-import { ToolExecutionError } from '../core/error-handler.js';
-import { CommonSchemas, ToolSchemaBuilder } from '../utils/validation.js';
-import { createMultiModalMessage, createImageContent, formatMcpResponse, createSuccessResponse, createErrorResponse, withRetry } from '../core/api-common.js';
-import { fileService } from '../core/file-service.js';
-import { chatService } from '../core/chat-service.js';
-/**
- * Image analysis service class
- */
-export class ImageAnalysisService {
-    chatService = chatService;
-    fileService = fileService;
-    MAX_IMAGE_SIZE_MB = 5;
-    /**
-     * Execute image analysis
-     * @param request Image analysis request
-     * @returns Analysis result
-     */
-    async analyzeImage(request) {
-        console.info('Starting image analysis', {
-            imageSource: request.imageSource,
-            prompt: request.prompt
-        });
-        try {
-            // Validate image source (file or URL) and size
-            await this.fileService.validateImageSource(request.imageSource, this.MAX_IMAGE_SIZE_MB);
-            // Validate prompt
-            if (!request.prompt || request.prompt.trim().length === 0) {
-                throw new ToolExecutionError('Prompt is required for image analysis', 'image-analysis', 'VALIDATION_ERROR', {
-                    toolName: 'image-analysis',
-                    operation: 'analyzeImage',
-                    metadata: { imageSource: request.imageSource }
-                });
-            }
-            // Handle image source (URL or local file)
-            let imageContent;
-            if (this.fileService.isUrl(request.imageSource)) {
-                // For URLs, pass directly without base64 encoding
-                imageContent = createImageContent(request.imageSource);
-            }
-            else {
-                // For local files, encode to base64
-                const imageData = await this.fileService.encodeImageToBase64(request.imageSource);
-                imageContent = createImageContent(imageData);
-            }
-            // Create multimodal message
-            const messages = createMultiModalMessage([imageContent], request.prompt);
-            const result = await this.chatService.visionCompletions(messages);
-            console.info('Image analysis completed', {
-                imageSource: request.imageSource
-            });
-            return result;
-        }
-        catch (error) {
-            console.error('Image analysis failed', {
-                error: error instanceof Error ? error.message : String(error),
-                imageSource: request.imageSource
-            });
-            if (error instanceof ToolExecutionError) {
-                throw error;
-            }
-            // Wrap unknown errors
-            throw new ToolExecutionError(`Image analysis failed: ${error.message}`, 'image-analysis', 'EXECUTION_ERROR', {
-                toolName: 'image-analysis',
-                operation: 'analyzeImage',
-                metadata: { imageSource: request.imageSource, originalError: error }
-            }, error);
-        }
-    }
-}
-/**
- * Register image analysis tool with MCP server
- * @param server MCP server instance
- */
-export function registerImageAnalysisTool(server) {
-    const analysisService = new ImageAnalysisService();
-    const retryableAnalyze = withRetry(analysisService.analyzeImage.bind(analysisService), 2, // Maximum 2 retries
-    1000 // 1 second delay
-    );
-    server.tool('analyze_image', 'Analyze an image using advanced AI vision models with comprehensive understanding capabilities. Supports both local files and remote URL. Maximum file size: 5MB', {
-        image_source: z.string().describe('Local file path or remote URL to the image (supports PNG, JPG, JPEG)'),
-        prompt: z.string().describe('Detailed text prompt. If the task is **front-end code replication**, the prompt you provide must be: "Describe in detail the layout structure, color style, main components, and interactive elements of the website in this image to facilitate subsequent code generation by the model." + your additional requirements. \ For **other tasks**, the prompt you provide must clearly describe what to analyze, extract, or understand from the image.')
-    }, async (params) => {
-        try {
-            // Validate parameters
-            const validationSchema = new ToolSchemaBuilder()
-                .required('image_source', CommonSchemas.nonEmptyString)
-                .required('prompt', CommonSchemas.nonEmptyString)
-                .build();
-            validationSchema.parse(params);
-            // Build request object
-            const request = {
-                imageSource: params.image_source,
-                prompt: params.prompt
-            };
-            // Execute analysis
-            const result = await retryableAnalyze(request);
-            const response = createSuccessResponse(result);
-            return formatMcpResponse(response);
-        }
-        catch (error) {
-            console.error('Tool execution failed', {
-                error: error instanceof Error ? error.message : String(error),
-                params
-            });
-            let errorResponse;
-            if (error instanceof z.ZodError) {
-                const validationErrors = error.issues.map((e) => `${e.path.join('.')}: ${e.message}`).join(', ');
-                errorResponse = createErrorResponse(`Validation failed: ${validationErrors}`);
-            }
-            else if (error instanceof FileNotFoundError) {
-                errorResponse = createErrorResponse(`Image file not found: ${error.message}`);
-            }
-            else if (error instanceof ApiError) {
-                errorResponse = createErrorResponse(`API error: ${error.message}`);
-            }
-            else {
-                errorResponse = createErrorResponse(`Unexpected error: ${error instanceof Error ? error.message : String(error)}`);
-            }
-            return formatMcpResponse(errorResponse);
-        }
-    });
-    console.info('Image analysis tool registered successfully');
-}

package/mcp-server/build/tools/video-analysis.js

@@ -1,125 +0,0 @@
-import { z } from 'zod';
-import { FileNotFoundError, ApiError } from '../types/index.js';
-import { ToolExecutionError } from '../core/error-handler.js';
-import { CommonSchemas, ToolSchemaBuilder } from '../utils/validation.js';
-import { createMultiModalMessage, createVideoContent, formatMcpResponse, createSuccessResponse, createErrorResponse, withRetry } from '../core/api-common.js';
-import { fileService } from '../core/file-service.js';
-import { chatService } from '../core/chat-service.js';
-/**
- * Video analysis service class
- */
-export class VideoAnalysisService {
-    chatService = chatService;
-    fileService = fileService;
-    MAX_VIDEO_SIZE_MB = 8;
-    /**
-     * Execute video analysis
-     * @param request Video analysis request
-     * @returns Analysis result
-     */
-    async analyzeVideo(request) {
-        console.info('Starting video analysis', {
-            videoSource: request.videoSource,
-            prompt: request.prompt
-        });
-        try {
-            // Validate video source (file or URL) and size
-            await this.fileService.validateVideoSource(request.videoSource, this.MAX_VIDEO_SIZE_MB);
-            // Validate prompt
-            if (!request.prompt || request.prompt.trim().length === 0) {
-                throw new ToolExecutionError('Prompt is required for video analysis', 'video-analysis', 'VALIDATION_ERROR', {
-                    toolName: 'video-analysis',
-                    operation: 'analyzeVideo',
-                    metadata: { videoSource: request.videoSource }
-                });
-            }
-            // Handle video source (URL or local file)
-            let videoContent;
-            if (this.fileService.isUrl(request.videoSource)) {
-                // For URLs, pass directly without base64 encoding
-                videoContent = createVideoContent(request.videoSource);
-            }
-            else {
-                // For local files, encode to base64
-                const videoData = await this.fileService.encodeVideoToBase64(request.videoSource);
-                videoContent = createVideoContent(videoData);
-            }
-            // Create multimodal message
-            const messages = createMultiModalMessage([videoContent], request.prompt);
-            const result = await this.chatService.visionCompletions(messages);
-            console.info('Video analysis completed', {
-                videoSource: request.videoSource
-            });
-            return result;
-        }
-        catch (error) {
-            console.error('Video analysis failed', {
-                error: error instanceof Error ? error.message : String(error),
-                videoSource: request.videoSource
-            });
-            if (error instanceof ToolExecutionError) {
-                throw error;
-            }
-            // Wrap unknown errors
-            throw new ToolExecutionError(`Video analysis failed: ${error.message}`, 'video-analysis', 'EXECUTION_ERROR', {
-                toolName: 'video-analysis',
-                operation: 'analyzeVideo',
-                metadata: { videoSource: request.videoSource, originalError: error }
-            }, error);
-        }
-    }
-}
-/**
- * Register video analysis tool with MCP server
- * @param server MCP server instance
- */
-export function registerVideoAnalysisTool(server) {
-    const analysisService = new VideoAnalysisService();
-    const retryableAnalyze = withRetry(analysisService.analyzeVideo.bind(analysisService), 2, // Maximum 2 retries
-    1000 // 1 second delay
-    );
-    server.tool('analyze_video', 'Analyze a video using advanced AI vision models with comprehensive understanding capabilities. Supports both local files and remote URL. Maximum local file size: 8MB', {
-        video_source: z.string().describe('Local file path or remote URL to the video (supports MP4, MOV, M4V)'),
-        prompt: z.string().describe('Detailed text prompt describing what to analyze, extract, or understand from the video')
-    }, async (params) => {
-        try {
-            // Validate parameters
-            const validationSchema = new ToolSchemaBuilder()
-                .required('video_source', CommonSchemas.nonEmptyString)
-                .required('prompt', CommonSchemas.nonEmptyString)
-                .build();
-            validationSchema.parse(params);
-            // Build request object
-            const request = {
-                videoSource: params.video_source,
-                prompt: params.prompt
-            };
-            // Execute analysis
-            const result = await retryableAnalyze(request);
-            const response = createSuccessResponse(result);
-            return formatMcpResponse(response);
-        }
-        catch (error) {
-            console.error('Tool execution failed', {
-                error: error instanceof Error ? error.message : String(error),
-                params
-            });
-            let errorResponse;
-            if (error instanceof z.ZodError) {
-                const validationErrors = error.issues.map((e) => `${e.path.join('.')}: ${e.message}`).join(', ');
-                errorResponse = createErrorResponse(`Validation failed: ${validationErrors}`);
-            }
-            else if (error instanceof FileNotFoundError) {
-                errorResponse = createErrorResponse(`Video file not found: ${error.message}`);
-            }
-            else if (error instanceof ApiError) {
-                errorResponse = createErrorResponse(`API error: ${error.message}`);
-            }
-            else {
-                errorResponse = createErrorResponse(`Unexpected error: ${error instanceof Error ? error.message : String(error)}`);
-            }
-            return formatMcpResponse(errorResponse);
-        }
-    });
-    console.info('Video analysis tool registered successfully');
-}

package/mcp-server/build/types/index.js

@@ -1,35 +0,0 @@
-// Error types
-export class McpError extends Error {
-    code;
-    context;
-    constructor(message, code, context) {
-        super(message);
-        this.code = code;
-        this.context = context;
-        this.name = 'McpError';
-    }
-}
-export class ValidationError extends McpError {
-    field;
-    constructor(message, context, field) {
-        super(message, 'VALIDATION_ERROR', context);
-        this.field = field;
-        this.name = 'ValidationError';
-    }
-}
-export class ApiError extends McpError {
-    statusCode;
-    details;
-    constructor(message, context, statusCode, details) {
-        super(message, 'API_ERROR', context);
-        this.statusCode = statusCode;
-        this.details = details;
-        this.name = 'ApiError';
-    }
-}
-export class FileNotFoundError extends McpError {
-    constructor(filePath) {
-        super(`File not found: ${filePath}`, 'FILE_NOT_FOUND', { filePath });
-        this.name = 'FileNotFoundError';
-    }
-}

package/mcp-server/build/types/validation-types.js

@@ -1 +0,0 @@
-export {};

package/mcp-server/build/utils/logger.js

@@ -1,120 +0,0 @@
-/**
- * Logger utility that writes to stderr and a log file.
- * Stderr keeps MCP JSON on stdout clean; file provides persistent logs.
- */
-import * as fs from 'fs';
-import * as path from 'path';
-import * as os from 'os';
-class Logger {
-    logStream;
-    logFilePath;
-    constructor(logFilePath) {
-        if (logFilePath) {
-            this.setLogFile(logFilePath);
-        }
-    }
-    setLogFile(logFilePath) {
-        try {
-            this.logFilePath = logFilePath;
-            const dir = path.dirname(logFilePath);
-            fs.mkdirSync(dir, { recursive: true });
-            if (this.logStream) {
-                this.logStream.end();
-            }
-            this.logStream = fs.createWriteStream(logFilePath, { flags: 'a' });
-        }
-        catch (err) {
-            const timestamp = new Date().toISOString();
-            const msg = `[${timestamp}] ERROR: Failed to initialize log file '${logFilePath}': ${String(err)}`;
-            process.stderr.write(msg + '\n');
-        }
-    }
-    safeStringify(obj) {
-        // Serialize Error objects so that message/stack and custom fields are visible
-        const replacer = (_key, value) => {
-            if (value instanceof Error) {
-                const base = {
-                    name: value.name,
-                    message: value.message,
-                    stack: value.stack
-                };
-                // Include enumerable own properties (e.g., code, statusCode, details, context)
-                for (const k of Object.keys(value)) {
-                    if (!(k in base)) {
-                        base[k] = value[k];
-                    }
-                }
-                return base;
-            }
-            return value;
-        };
-        try {
-            return JSON.stringify(obj, replacer);
-        }
-        catch {
-            try {
-                return String(obj);
-            }
-            catch {
-                return '[Unserializable]';
-            }
-        }
-    }
-    write(level, message, ...args) {
-        const timestamp = new Date().toISOString();
-        const serializedArgs = args.length > 0 ? ` ${this.safeStringify(args)}` : '';
-        const logMessage = `[${timestamp}] ${level.toUpperCase()}: ${message}${serializedArgs}`;
-        // Write to stderr (visible console output without polluting stdout)
-        process.stderr.write(logMessage + '\n');
-        // Write to log file if configured
-        if (this.logStream) {
-            this.logStream.write(logMessage + '\n');
-        }
-    }
-    info(message, ...args) {
-        this.write('info', message, ...args);
-    }
-    error(message, ...args) {
-        this.write('error', message, ...args);
-    }
-    warn(message, ...args) {
-        this.write('warn', message, ...args);
-    }
-    debug(message, ...args) {
-        this.write('debug', message, ...args);
-    }
-    log(message, ...args) {
-        this.write('info', message, ...args);
-    }
-}
-export const logger = new Logger();
-/**
- * Override global console to redirect to stderr
- * This prevents console output from interfering with MCP JSON protocol
- */
-export function setupConsoleRedirection() {
-    const originalConsole = { ...console };
-    // Cross-platform log file path:
-    // - If env ZAI_MCP_LOG_PATH is set, use it
-    // - Otherwise use user home directory: ~/.zai/zai-mcp-YYYY-MM-DD.log (Windows/macOS/Linux)
-    const resolveLogFilePath = () => {
-        const envPath = process.env.ZAI_MCP_LOG_PATH;
-        if (envPath && envPath.trim().length > 0) {
-            return path.resolve(envPath);
-        }
-        const homeDir = os.homedir();
-        const now = new Date();
-        const yyyy = now.getFullYear();
-        const mm = String(now.getMonth() + 1).padStart(2, '0');
-        const dd = String(now.getDate()).padStart(2, '0');
-        const dateStr = `${yyyy}-${mm}-${dd}`;
-        return path.join(homeDir, '.zai', `zai-mcp-${dateStr}.log`);
-    };
-    logger.setLogFile(resolveLogFilePath());
-    console.info = logger.info.bind(logger);
-    console.error = logger.error.bind(logger);
-    console.warn = logger.warn.bind(logger);
-    console.debug = logger.debug.bind(logger);
-    console.log = logger.log.bind(logger);
-    return originalConsole;
-}