@translateimage/mcp-server 1.0.0

package/dist/src/utils/errors.d.ts

@@ -0,0 +1,17 @@
+import { McpError } from "@modelcontextprotocol/sdk/types.js";
+export declare class ImageTranslationError extends McpError {
+    constructor(message: string);
+}
+export declare class InvalidInputError extends McpError {
+    constructor(message: string);
+}
+export declare class ApiKeyMissingError extends McpError {
+    constructor(keyName?: string);
+}
+export declare class ImageTooLargeError extends McpError {
+    constructor(message: string);
+}
+export declare class UnsupportedFormatError extends McpError {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/src/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAa,MAAM,oCAAoC,CAAC;AAEzE,qBAAa,qBAAsB,SAAQ,QAAQ;gBACrC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,iBAAkB,SAAQ,QAAQ;gBACjC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,kBAAmB,SAAQ,QAAQ;gBAClC,OAAO,GAAE,MAAc;CASpC;AAED,qBAAa,kBAAmB,SAAQ,QAAQ;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,sBAAuB,SAAQ,QAAQ;gBACtC,OAAO,EAAE,MAAM;CAI5B"}

package/dist/src/utils/errors.js

@@ -0,0 +1,35 @@
+import { McpError, ErrorCode } from "@modelcontextprotocol/sdk/types.js";
+export class ImageTranslationError extends McpError {
+    constructor(message) {
+        super(ErrorCode.InternalError, message);
+        this.name = "ImageTranslationError";
+    }
+}
+export class InvalidInputError extends McpError {
+    constructor(message) {
+        super(ErrorCode.InvalidParams, message);
+        this.name = "InvalidInputError";
+    }
+}
+export class ApiKeyMissingError extends McpError {
+    constructor(keyName = "API") {
+        const envVar = keyName === "TranslateImage"
+            ? "TRANSLATEIMAGE_API_KEY"
+            : `${keyName.toUpperCase()}_API_KEY`;
+        const message = `${keyName} API key is required. Set the ${envVar} environment variable.`;
+        super(ErrorCode.InvalidParams, message);
+        this.name = "ApiKeyMissingError";
+    }
+}
+export class ImageTooLargeError extends McpError {
+    constructor(message) {
+        super(ErrorCode.InvalidParams, message);
+        this.name = "ImageTooLargeError";
+    }
+}
+export class UnsupportedFormatError extends McpError {
+    constructor(message) {
+        super(ErrorCode.InvalidParams, message);
+        this.name = "UnsupportedFormatError";
+    }
+}

package/dist/src/utils/image.d.ts

@@ -0,0 +1,34 @@
+import { ImageInput } from "../schemas/common.js";
+/**
+ * Converts a URL to base64 and MIME type
+ */
+export declare function urlToBase64(url: string): Promise<{
+    base64: string;
+    mimeType: string;
+}>;
+/**
+ * Validates if a string is valid base64
+ */
+export declare function isValidBase64(str: string): boolean;
+/**
+ * Converts base64 string to Blob
+ */
+export declare function base64ToBlob(base64: string, mimeType: string): Blob;
+/**
+ * Converts Blob to base64 string using Node.js Buffer (efficient for large images)
+ */
+export declare function blobToBase64(blob: Blob): Promise<string>;
+/**
+ * Validates image size (throws if > 10MB)
+ */
+export declare function validateImageSize(blob: Blob): void;
+/**
+ * Validates MIME type is supported
+ */
+export declare function validateMimeType(mimeType: string): void;
+/**
+ * Resolves ImageInput to a Blob with validation
+ * Handles URL, base64 (raw and data URL), and validates size/format
+ */
+export declare function resolveImageInput(input: ImageInput): Promise<Blob>;
+//# sourceMappingURL=image.d.ts.map

package/dist/src/utils/image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../../src/utils/image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAWlD;;GAEG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAW/C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAMlD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAOnE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAG9D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAOlD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAOvD;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAiCxE"}

package/dist/src/utils/image.js

@@ -0,0 +1,105 @@
+import { ImageTooLargeError, UnsupportedFormatError } from "./errors.js";
+const ALLOWED_MIME_TYPES = [
+    "image/jpeg",
+    "image/png",
+    "image/webp",
+    "image/gif",
+];
+const MAX_IMAGE_SIZE = 10 * 1024 * 1024; // 10MB
+/**
+ * Converts a URL to base64 and MIME type
+ */
+export async function urlToBase64(url) {
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch image from URL: ${response.statusText}`);
+    }
+    const blob = await response.blob();
+    const base64 = await blobToBase64(blob);
+    const mimeType = blob.type || "image/png";
+    return { base64, mimeType };
+}
+/**
+ * Validates if a string is valid base64
+ */
+export function isValidBase64(str) {
+    try {
+        return btoa(atob(str)) === str;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Converts base64 string to Blob
+ */
+export function base64ToBlob(base64, mimeType) {
+    const binaryString = atob(base64);
+    const bytes = new Uint8Array(binaryString.length);
+    for (let i = 0; i < binaryString.length; i++) {
+        bytes[i] = binaryString.charCodeAt(i);
+    }
+    return new Blob([bytes], { type: mimeType });
+}
+/**
+ * Converts Blob to base64 string using Node.js Buffer (efficient for large images)
+ */
+export async function blobToBase64(blob) {
+    const arrayBuffer = await blob.arrayBuffer();
+    return Buffer.from(arrayBuffer).toString("base64");
+}
+/**
+ * Validates image size (throws if > 10MB)
+ */
+export function validateImageSize(blob) {
+    if (blob.size > MAX_IMAGE_SIZE) {
+        const sizeMB = (blob.size / (1024 * 1024)).toFixed(2);
+        throw new ImageTooLargeError(`Image too large: ${sizeMB}MB exceeds 10MB limit`);
+    }
+}
+/**
+ * Validates MIME type is supported
+ */
+export function validateMimeType(mimeType) {
+    if (!ALLOWED_MIME_TYPES.includes(mimeType)) {
+        const format = mimeType.split("/")[1] || mimeType;
+        throw new UnsupportedFormatError(`Unsupported image format: ${format}. Supported: png, jpeg, webp, gif`);
+    }
+}
+/**
+ * Resolves ImageInput to a Blob with validation
+ * Handles URL, base64 (raw and data URL), and validates size/format
+ */
+export async function resolveImageInput(input) {
+    let blob;
+    let mimeType;
+    if (input.url) {
+        // Fetch from URL
+        const { base64, mimeType: fetchedMimeType } = await urlToBase64(input.url);
+        mimeType = fetchedMimeType;
+        blob = base64ToBlob(base64, mimeType);
+    }
+    else if (input.base64) {
+        // Handle base64 input
+        if (input.base64.startsWith("data:")) {
+            // Parse data URL
+            const [header, base64Data] = input.base64.split(",");
+            const mimeMatch = header.match(/data:([^;]+)/);
+            mimeType = mimeMatch ? mimeMatch[1] : "image/png";
+            blob = base64ToBlob(base64Data, mimeType);
+        }
+        else {
+            // Raw base64 - mimeType must be provided (validated by schema)
+            mimeType = input.mimeType || "image/png";
+            blob = base64ToBlob(input.base64, mimeType);
+        }
+    }
+    else {
+        throw new Error("Either url or base64 must be provided");
+    }
+    // Validate MIME type
+    validateMimeType(mimeType);
+    // Validate size
+    validateImageSize(blob);
+    return blob;
+}

package/dist/src/utils/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./image.js";
+export * from "./errors.js";
+export * from "./config.js";
+export * from "./api-client.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC"}

package/dist/src/utils/index.js

@@ -0,0 +1,4 @@
+export * from "./image.js";
+export * from "./errors.js";
+export * from "./config.js";
+export * from "./api-client.js";