@fastcoder/vision-mcp-server 1.0.0

package/build/utils/logger.js

@@ -0,0 +1,119 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+/**
+ * Logger utility that writes to stderr and a log file.
+ * Stderr keeps MCP JSON on stdout clean; file provides persistent logs.
+ */
+class Logger {
+    logStream;
+    constructor(logFilePath) {
+        if (logFilePath) {
+            this.setLogFile(logFilePath);
+        }
+    }
+    setLogFile(logFilePath) {
+        try {
+            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 VISION_MCP_LOG_PATH is set, use it
+    // - Otherwise use user home directory: ~/.vision/vision-mcp-YYYY-MM-DD.log (Windows/macOS/Linux)
+    const resolveLogFilePath = () => {
+        const envPath = process.env.VISION_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, '.vision', `vision-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;
+}
+//# sourceMappingURL=logger.js.map

package/build/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB;;;GAGG;AACH,MAAM,MAAM;IACF,SAAS,CAAkB;IAEnC,YAAY,WAAoB;QAC9B,IAAI,WAAW,EAAE,CAAC;YAChB,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,UAAU,CAAC,WAAmB;QAC5B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YACtC,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACvC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACnB,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;YACvB,CAAC;YACD,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC,iBAAiB,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QACrE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC3C,MAAM,GAAG,GAAG,IAAI,SAAS,2CAA2C,WAAW,MAAM,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YACnG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAEO,aAAa,CAAC,GAAY;QAChC,8EAA8E;QAC9E,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,KAAc,EAAE,EAAE;YAChD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,MAAM,IAAI,GAA4B;oBACpC,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,KAAK,EAAE,KAAK,CAAC,KAAK;iBACnB,CAAC;gBACF,+EAA+E;gBAC/E,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;oBACnC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC;wBACjB,IAAI,CAAC,CAAC,CAAC,GAAI,KAA4C,CAAC,CAAC,CAAC,CAAC;oBAC7D,CAAC;gBACH,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC,CAAC;QAEF,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC;gBACH,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;YACrB,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,kBAAkB,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,KAAa,EAAE,OAAe,EAAE,GAAG,IAAe;QAC9D,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,cAAc,GAClB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,MAAM,UAAU,GAAG,IAAI,SAAS,KAAK,KAAK,CAAC,WAAW,EAAE,KAAK,OAAO,GAAG,cAAc,EAAE,CAAC;QAExF,oEAAoE;QACpE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;QAExC,kCAAkC;QAClC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACxC,CAAC;IAED,GAAG,CAAC,OAAe,EAAE,GAAG,IAAe;QACrC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACvC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;AAEnC;;;GAGG;AACH,MAAM,UAAU,uBAAuB;IACrC,MAAM,eAAe,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;IAEvC,gCAAgC;IAChC,8CAA8C;IAC9C,iGAAiG;IACjG,MAAM,kBAAkB,GAAG,GAAW,EAAE;QACtC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;QAChD,IAAI,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;QAED,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QAC/B,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACvD,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAClD,MAAM,OAAO,GAAG,GAAG,IAAI,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,cAAc,OAAO,MAAM,CAAC,CAAC;IACpE,CAAC,CAAC;IAEF,MAAM,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAExC,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEtC,OAAO,eAAe,CAAC;AACzB,CAAC"}

package/build/utils/validation.d.ts

@@ -0,0 +1,87 @@
+import { z } from 'zod';
+/**
+ * Runtime type validator
+ */
+export declare class RuntimeValidator {
+    /**
+     * Validate data against specified Zod schema
+     */
+    static validate<T>(data: unknown, schema: z.ZodSchema<T>, options?: {
+        throwOnError?: boolean;
+        customMessage?: string;
+        logErrors?: boolean;
+    }): {
+        success: boolean;
+        data?: T;
+        error?: {
+            message: string;
+            code: string;
+        };
+    };
+    /**
+     * Safe validation, does not throw exceptions
+     */
+    static safeValidate<T>(data: unknown, schema: z.ZodSchema<T>): ReturnType<typeof RuntimeValidator.validate<T>>;
+    /**
+     * Parse Zod error to standard validation error format
+     */
+    static parseZodError(error: z.ZodError): Array<{
+        message: string;
+        field: string;
+        code: string;
+        expected: string;
+        received: string;
+    }>;
+    /**
+     * Get expected type description
+     */
+    static getExpectedType(issue: z.ZodIssue): string;
+    /**
+     * Sanitize sensitive data for logging
+     */
+    static sanitizeData(data: unknown): unknown;
+}
+/**
+ * Common validation schemas
+ */
+export declare const CommonSchemas: {
+    /** Non-empty string */
+    nonEmptyString: z.ZodString;
+    /** Positive integer */
+    positiveInteger: z.ZodNumber;
+    /** Non-negative integer */
+    nonNegativeInteger: z.ZodNumber;
+    /** URL format */
+    url: z.ZodString;
+    /** Email format */
+    email: z.ZodString;
+    /** UUID format */
+    uuid: z.ZodString;
+    /** File path */
+    filePath: z.ZodEffects<z.ZodString, string, string>;
+    /** Tool name */
+    toolName: z.ZodString;
+};
+/**
+ * Tool parameter validation schema builder
+ */
+export declare class ToolSchemaBuilder<T extends Record<string, z.ZodTypeAny>> {
+    private schema;
+    /**
+     * Add required field
+     */
+    required<K extends keyof T>(name: K, schema: z.ZodTypeAny): ToolSchemaBuilder<T>;
+    /**
+     * Add optional field
+     */
+    optional<K extends keyof T>(name: K, schema: z.ZodTypeAny): ToolSchemaBuilder<T>;
+    /**
+     * Add field with default value
+     */
+    withDefault<K extends keyof T>(name: K, schema: z.ZodTypeAny, defaultValue: z.input<z.ZodTypeAny>): ToolSchemaBuilder<T>;
+    /**
+     * Build final validation schema
+     */
+    build(): z.ZodObject<Record<keyof T, z.ZodTypeAny>>;
+}
+//# sourceMappingURL=validation.d.ts.map

package/build/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,qBAAa,gBAAgB;IAC3B;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,EACf,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EACtB,OAAO,GAAE;QACP,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,OAAO,CAAC;KAChB,GACL;QACD,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,CAAC,CAAC;QACT,KAAK,CAAC,EAAE;YACN,OAAO,EAAE,MAAM,CAAC;YAChB,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;KACH;IAoCD;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,CAAC,EACnB,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GACrB,UAAU,CAAC,OAAO,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAIlD;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,GAAG,KAAK,CAAC;QAC7C,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IAaF;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,GAAG,MAAM;IAajD;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO;CAgB5C;AAED;;GAEG;AACH,eAAO,MAAM,aAAa;IACxB,uBAAuB;;IAEvB,uBAAuB;;IAEvB,2BAA2B;;IAK3B,iBAAiB;;IAEjB,mBAAmB;;IAEnB,kBAAkB;;IAElB,gBAAgB;;IAKhB,gBAAgB;;CAOjB,CAAC;AAEF;;GAEG;AACH,qBAAa,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;IACnE,OAAO,CAAC,MAAM,CAA8C;IAE5D;;OAEG;IACH,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,EACxB,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,CAAC,CAAC,UAAU,GACnB,iBAAiB,CAAC,CAAC,CAAC;IAKvB;;OAEG;IACH,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,EACxB,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,CAAC,CAAC,UAAU,GACnB,iBAAiB,CAAC,CAAC,CAAC;IAKvB;;OAEG;IACH,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,EAC3B,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,CAAC,CAAC,UAAU,EACpB,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,GAClC,iBAAiB,CAAC,CAAC,CAAC;IAKvB;;OAEG;IACH,KAAK,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;CAGpD"}

package/build/utils/validation.js

@@ -0,0 +1,155 @@
+import { z } from 'zod';
+import { ValidationError } from '../types/index.js';
+/**
+ * Runtime type validator
+ */
+export class RuntimeValidator {
+    /**
+     * Validate data against specified Zod schema
+     */
+    static validate(data, schema, options = {}) {
+        const { throwOnError = true, customMessage, logErrors = true } = options;
+        try {
+            const result = schema.parse(data);
+            return {
+                success: true,
+                data: result
+            };
+        }
+        catch (error) {
+            const validationErrors = this.parseZodError(error);
+            if (logErrors) {
+                console.warn('Validation failed', {
+                    errors: validationErrors,
+                    data: this.sanitizeData(data)
+                });
+            }
+            if (throwOnError) {
+                const message = customMessage ||
+                    `Validation failed: ${validationErrors.map(e => e.message).join(', ')}`;
+                throw new ValidationError(message, { errors: validationErrors });
+            }
+            return {
+                success: false,
+                error: {
+                    message: validationErrors.map(e => e.message).join(', '),
+                    code: 'VALIDATION_ERROR'
+                }
+            };
+        }
+    }
+    /**
+     * Safe validation, does not throw exceptions
+     */
+    static safeValidate(data, schema) {
+        return this.validate(data, schema, { throwOnError: false });
+    }
+    /**
+     * Parse Zod error to standard validation error format
+     */
+    static parseZodError(error) {
+        return error.issues.map(issue => ({
+            message: issue.message,
+            field: issue.path.join('.'),
+            code: issue.code,
+            expected: this.getExpectedType(issue),
+            received: 'received' in issue
+                ? String(issue.received)
+                : 'unknown'
+        }));
+    }
+    /**
+     * Get expected type description
+     */
+    static getExpectedType(issue) {
+        switch (issue.code) {
+            case 'invalid_type':
+                return issue.expected;
+            case 'too_small':
+                return `minimum ${issue.minimum}`;
+            case 'too_big':
+                return `maximum ${issue.maximum}`;
+            default:
+                return 'valid value';
+        }
+    }
+    /**
+     * Sanitize sensitive data for logging
+     */
+    static sanitizeData(data) {
+        if (typeof data !== 'object' || data === null) {
+            return data;
+        }
+        const sensitiveKeys = ['password', 'token', 'secret', 'key', 'auth'];
+        const sanitized = { ...data };
+        for (const key of Object.keys(sanitized)) {
+            if (sensitiveKeys.some(sensitive => key.toLowerCase().includes(sensitive))) {
+                sanitized[key] = '[REDACTED]';
+            }
+        }
+        return sanitized;
+    }
+}
+/**
+ * Common validation schemas
+ */
+export const CommonSchemas = {
+    /** Non-empty string */
+    nonEmptyString: z.string().min(1, 'String cannot be empty'),
+    /** Positive integer */
+    positiveInteger: z.number().int().positive('Must be a positive integer'),
+    /** Non-negative integer */
+    nonNegativeInteger: z
+        .number()
+        .int()
+        .min(0, 'Must be a non-negative integer'),
+    /** URL format */
+    url: z.string().url('Must be a valid URL'),
+    /** Email format */
+    email: z.string().email('Must be a valid email address'),
+    /** UUID format */
+    uuid: z.string().uuid('Must be a valid UUID'),
+    /** File path */
+    filePath: z
+        .string()
+        .min(1)
+        .refine(path => !path.includes('..'), 'File path cannot contain ".."'),
+    /** Tool name */
+    toolName: z
+        .string()
+        .regex(/^[a-z][a-z0-9-]*[a-z0-9]$/, 'Tool name must be lowercase, start with letter, and contain only letters, numbers, and hyphens')
+};
+/**
+ * Tool parameter validation schema builder
+ */
+export class ToolSchemaBuilder {
+    schema = {};
+    /**
+     * Add required field
+     */
+    required(name, schema) {
+        this.schema[name] = schema;
+        return this;
+    }
+    /**
+     * Add optional field
+     */
+    optional(name, schema) {
+        this.schema[name] = schema.optional();
+        return this;
+    }
+    /**
+     * Add field with default value
+     */
+    withDefault(name, schema, defaultValue) {
+        this.schema[name] = schema.default(() => defaultValue);
+        return this;
+    }
+    /**
+     * Build final validation schema
+     */
+    build() {
+        return z.object(this.schema);
+    }
+}
+//# sourceMappingURL=validation.js.map

package/build/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;GAEG;AACH,MAAM,OAAO,gBAAgB;IAC3B;;OAEG;IACH,MAAM,CAAC,QAAQ,CACb,IAAa,EACb,MAAsB,EACtB,UAII,EAAE;QASN,MAAM,EAAE,YAAY,GAAG,IAAI,EAAE,aAAa,EAAE,SAAS,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;QAEzE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAClC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,MAAM;aACb,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,gBAAgB,GAAG,IAAI,CAAC,aAAa,CAAC,KAAmB,CAAC,CAAC;YAEjE,IAAI,SAAS,EAAE,CAAC;gBACd,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE;oBAChC,MAAM,EAAE,gBAAgB;oBACxB,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;iBAC9B,CAAC,CAAC;YACL,CAAC;YAED,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,OAAO,GACX,aAAa;oBACb,sBAAsB,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1E,MAAM,IAAI,eAAe,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;YACnE,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE;oBACL,OAAO,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;oBACxD,IAAI,EAAE,kBAAkB;iBACzB;aACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,YAAY,CACjB,IAAa,EACb,MAAsB;QAEtB,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,KAAiB;QAOpC,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAChC,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;YAC3B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC;YACrC,QAAQ,EACN,UAAU,IAAI,KAAK;gBACjB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;gBACxB,CAAC,CAAC,SAAS;SAChB,CAAC,CAAC,CAAC;IACN,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,KAAiB;QACtC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,cAAc;gBACjB,OAAO,KAAK,CAAC,QAAQ,CAAC;YACxB,KAAK,WAAW;gBACd,OAAO,WAAY,KAA4B,CAAC,OAAO,EAAE,CAAC;YAC5D,KAAK,SAAS;gBACZ,OAAO,WAAY,KAA0B,CAAC,OAAO,EAAE,CAAC;YAC1D;gBACE,OAAO,aAAa,CAAC;QACzB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,IAAa;QAC/B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAC9C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,aAAa,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACrE,MAAM,SAAS,GAAG,EAAE,GAAI,IAAgC,EAAE,CAAC;QAE3D,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACzC,IAAI,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;gBAC3E,SAAS,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC;YAChC,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,uBAAuB;IACvB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,wBAAwB,CAAC;IAC3D,uBAAuB;IACvB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IACxE,2BAA2B;IAC3B,kBAAkB,EAAE,CAAC;SAClB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,EAAE,gCAAgC,CAAC;IAC3C,iBAAiB;IACjB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,qBAAqB,CAAC;IAC1C,mBAAmB;IACnB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,+BAA+B,CAAC;IACxD,kBAAkB;IAClB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,sBAAsB,CAAC;IAC7C,gBAAgB;IAChB,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,+BAA+B,CAAC;IACxE,gBAAgB;IAChB,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,KAAK,CACJ,2BAA2B,EAC3B,gGAAgG,CACjG;CACJ,CAAC;AAEF;;GAEG;AACH,MAAM,OAAO,iBAAiB;IACpB,MAAM,GAA2C,EAAE,CAAC;IAE5D;;OAEG;IACH,QAAQ,CACN,IAAO,EACP,MAAoB;QAEpB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,QAAQ,CACN,IAAO,EACP,MAAoB;QAEpB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,WAAW,CACT,IAAO,EACP,MAAoB,EACpB,YAAmC;QAEnC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK;QACH,OAAO,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAuC,CAAC,CAAC;IAChE,CAAC;CACF"}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@fastcoder/vision-mcp-server",
+  "version": "1.0.0",
+  "description": "MCP Server for Vision Analysis - A Model Context Protocol server that provides image analysis capabilities using OpenAI API",
+  "main": "build/index.js",
+  "type": "module",
+  "types": "build/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./build/index.d.ts",
+      "default": "./build/index.js"
+    }
+  },
+  "bin": {
+    "vision-mcp-server": "./build/index.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/calandnong/vision-mcp-server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/calandnong/vision-mcp-server/issues"
+  },
+  "homepage": "https://github.com/calandnong/vision-mcp-server#readme",
+  "scripts": {
+    "build": "tsc && chmod 755 build/index.js",
+    "start": "node build/index.js",
+    "dev": "tsx watch src/index.ts",
+    "inspector": "npx @modelcontextprotocol/inspector --transport stdio node build/index.js",
+    "inspector:dev": "npx @modelcontextprotocol/inspector --transport stdio tsx src/index.ts",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "prepare": "npm run build",
+    "clean": "rm -rf build"
+  },
+  "keywords": [
+    "vision",
+    "mcp",
+    "openai",
+    "image-analysis",
+    "ocr",
+    "ui-analysis"
+  ],
+  "author": "Vision MCP Team",
+  "license": "Apache-2.0",
+  "files": [
+    "build",
+    "README.md",
+    "README.zh-CN.md"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.17.5",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/inspector": "^0.18.0",
+    "@types/node": "^24.3.1",
+    "@vitest/coverage-v8": "^2.1.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.9.2",
+    "vitest": "^2.1.0"
+  }
+}