@metalevel/snapix-mcp-server 0.1.1

package/dist/tools/upload-image.js

@@ -0,0 +1,68 @@
+import { z } from "zod";
+import { handleToolError } from "../errors.js";
+export function registerUploadImageTool(server, client) {
+    server.registerTool("snapix_upload_image", {
+        title: "Upload an image",
+        description: "Upload an image to SnapiX cloud storage either from a remote URL (imageUrl) or as a base64-encoded binary (imageBase64). Exactly one of the two must be provided. Optionally convert to different formats (JPEG, PNG, WebP, AVIF), resize, and assign to galleries. Returns CDN URLs for all generated variants. Costs 1+ App credits.",
+        inputSchema: z
+            .object({
+            imageUrl: z
+                .url()
+                .optional()
+                .describe("URL of the image to upload (mutually exclusive with imageBase64)"),
+            imageBase64: z
+                .string()
+                .optional()
+                .describe("Base64-encoded image binary (mutually exclusive with imageUrl)"),
+            contentType: z
+                .string()
+                .optional()
+                .describe("MIME type of the image (e.g. 'image/png', 'image/jpeg'). Recommended when using imageBase64."),
+            name: z.string().max(256).optional().describe("Name for the uploaded image"),
+            description: z.string().max(4096).optional().describe("Description of the image"),
+            formatOptions: z
+                .array(z.object({
+                format: z.enum(["jpeg", "png", "webp", "avif"]).describe("Output image format"),
+            }))
+                .optional()
+                .describe("Array of output format options. Each creates a variant."),
+            resizeOptions: z
+                .array(z.object({
+                width: z.number().positive().optional().describe("Target width in pixels"),
+                height: z.number().positive().optional().describe("Target height in pixels"),
+            }))
+                .optional()
+                .describe("Array of resize options. Each creates a variant. Empty object keeps original size."),
+            ratio: z
+                .number()
+                .positive()
+                .optional()
+                .describe("Aspect ratio as a number (e.g., 1.777 for 16:9, 1.333 for 4:3)"),
+            galleries: z
+                .array(z.uuid())
+                .optional()
+                .describe("Array of gallery IDs to add the image to"),
+            bucketKey: z
+                .string()
+                .optional()
+                .describe("Storage bucket key (defaults to primary bucket)"),
+        })
+            .refine((data) => !!(data.imageUrl ?? data.imageBase64), {
+            message: "Either imageUrl or imageBase64 must be provided",
+        })
+            .refine((data) => !(data.imageUrl && data.imageBase64), {
+            message: "imageUrl and imageBase64 are mutually exclusive — provide only one",
+        }),
+    }, async (params) => {
+        try {
+            const result = await client.uploadImage(params);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+}
+//# sourceMappingURL=upload-image.js.map

package/dist/tools/upload-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-image.js","sourceRoot":"","sources":["../../src/tools/upload-image.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,UAAU,uBAAuB,CAAC,MAAiB,EAAE,MAAoB;IAC7E,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,wUAAwU;QAC1U,WAAW,EAAE,CAAC;aACX,MAAM,CAAC;YACN,QAAQ,EAAE,CAAC;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,QAAQ,CAAC,kEAAkE,CAAC;YAC/E,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,gEAAgE,CAAC;YAC7E,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,8FAA8F,CAC/F;YACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;YAC5E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;YACjF,aAAa,EAAE,CAAC;iBACb,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;gBACP,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,qBAAqB,CAAC;aAChF,CAAC,CACH;iBACA,QAAQ,EAAE;iBACV,QAAQ,CAAC,yDAAyD,CAAC;YACtE,aAAa,EAAE,CAAC;iBACb,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;gBACP,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;gBAC1E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;aAC7E,CAAC,CACH;iBACA,QAAQ,EAAE;iBACV,QAAQ,CACP,oFAAoF,CACrF;YACH,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,EAAE;iBACV,QAAQ,CAAC,gEAAgE,CAAC;YAC7E,SAAS,EAAE,CAAC;iBACT,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;iBACf,QAAQ,EAAE;iBACV,QAAQ,CAAC,0CAA0C,CAAC;YACvD,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,iDAAiD,CAAC;SAC/D,CAAC;aACD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAC,EAAE;YACvD,OAAO,EAAE,iDAAiD;SAC3D,CAAC;aACD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAC,EAAE;YACtD,OAAO,EAAE,oEAAoE;SAC9E,CAAC;KACL,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAEhD,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC5E,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,67 @@
+export interface SnapixClientConfig {
+    baseUrl: string;
+    apiKey: string;
+}
+export type CreateServerOptions = Omit<SnapixClientConfig, "baseUrl"> & {
+    baseUrl?: string;
+};
+export interface ListImagesParams {
+    page?: number;
+    limit?: number;
+    sort?: "asc" | "desc";
+    bucketKey?: string;
+}
+export interface UploadImageParams {
+    imageUrl?: string;
+    imageBase64?: string;
+    imageContentType?: string;
+    name?: string;
+    description?: string;
+    contentType?: string;
+    ratio?: number;
+    resizeOptions?: Record<string, unknown>[];
+    formatOptions?: {
+        format: string;
+        options?: Record<string, unknown>;
+    }[];
+    galleries?: string[];
+    bucketKey?: string;
+    prefix?: string;
+    storageKeyHandling?: "unique" | "default";
+}
+export interface GenerateImageParams {
+    promptText: string;
+    imageUrl?: string;
+    name?: string;
+    description?: string;
+    ratio?: number;
+    resizeOptions?: Record<string, unknown>[];
+    formatOptions?: {
+        format: string;
+        options?: Record<string, unknown>;
+    }[];
+    galleries?: string[];
+    bucketKey?: string;
+    aiConfig?: Record<string, unknown>;
+}
+export interface UpdateImageParams {
+    name?: string;
+    description?: string;
+    galleries?: string[];
+    formatOptions?: {
+        format: string;
+        options?: Record<string, unknown>;
+    };
+    resizeOptions?: Record<string, unknown>;
+}
+export interface CreateGalleryParams {
+    name: string;
+    isPublic?: boolean;
+    bucketKey?: string;
+    imageIds?: string[];
+}
+export interface UpdateGalleryParams {
+    name?: string;
+    isPublic?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,kBAAkB,EAAE,SAAS,CAAC,GAAG;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAC1C,aAAa,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EAAE,CAAC;IACxE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;CAC3C;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAC1C,aAAa,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EAAE,CAAC;IACxE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IACtE,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@metalevel/snapix-mcp-server",
+  "version": "0.1.1",
+  "mcpBaseUrl": "https://www.snapix.space",
+  "description": "MCP server for SnapiX - image optimization, conversion, generation, and gallery management via the Model Context Protocol",
+  "type": "module",
+  "license": "MIT",
+  "author": "pa4080",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pa4080/snapix-mcp-server"
+  },
+  "homepage": "https://snapix.metalevel.tech/docs/mcp",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "snapix",
+    "image-optimization",
+    "image-conversion",
+    "ai",
+    "llm"
+  ],
+  "bin": {
+    "snapix-mcp-server": "./dist/index.js"
+  },
+  "main": "./dist/server.js",
+  "types": "./dist/server.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/server.js",
+      "types": "./dist/server.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js"
+  }
+}