@codingmantra/mcp-server 0.1.1 → 0.1.3

package/README.md

@@ -4,9 +4,9 @@ A **Model Context Protocol (MCP)** server that connects AI agents (like Claude D
 
 ## Features
 
-- **Product Photography** — Generate AI studio product photos with custom scenes
-- **Logo Creator** — Generate AI brand logos with style and color customization
-- **QR Code Generator** — Create custom QR codes (URL, text, WiFi, vCard, UPI, email)
+- **Product Photography** — Generate AI studio product photos with custom scenes, resolutions, templates, and dynamic logo/text overlays.
+- **Logo Creator** — Generate AI brand logos with style, resolution, references, and color customization.
+- **QR Code Generator** — Create custom QR codes (URL, text, WiFi, vCard, UPI, email) with branding and colors.
 
 ## Setup
 

package/build/index.js

@@ -48,6 +48,30 @@ const GENERATE_PRODUCT_PHOTO_TOOL = {
             referenceImage: {
                 type: "string",
                 description: "An optional URL or data URI of a reference image to guide style."
+            },
+            promptId: {
+                type: "string",
+                description: "Optional ID of a pre-defined prompt template."
+            },
+            logoImage: {
+                type: "string",
+                description: "Optional URL or Base64 data URI of a logo to place on the image."
+            },
+            logoPlacement: {
+                type: "string",
+                description: "Where to place the logo (e.g., 'top-left', 'bottom-right')."
+            },
+            logoSize: {
+                type: "number",
+                description: "Scale of the logo overlay (0.1 to 1.0)."
+            },
+            overlayText: {
+                type: "string",
+                description: "Optional text to overlay on the image."
+            },
+            marketingText: {
+                type: "string",
+                description: "Optional marketing text to overlay."
             }
         },
         required: ["productImages", "scenePrompt"]
@@ -94,6 +118,14 @@ const GENERATE_LOGO_TOOL = {
             resolution: {
                 type: "string",
                 description: "Output resolution (e.g., '1K', '2K'). Default is '1K'.",
+            },
+            promptId: {
+                type: "string",
+                description: "Optional ID or value of a pre-defined style template."
+            },
+            referenceImage: {
+                type: "string",
+                description: "An optional general style reference image URL or data URI."
             }
         },
         required: ["companyName", "stylePrompt"]
@@ -149,6 +181,64 @@ const GENERATE_QR_CODE_SIMPLE_TOOL = {
         required: ["text"]
     }
 };
+const COMMON_VIDEO_PROPERTIES = {
+    prompt: { type: "string", description: "Detailed video description or prompt." },
+    mainImage: { type: "string", description: "Base64 data URI or URL for the main image (Image-to-Video mode)." },
+    startImage: { type: "string", description: "Base64 data URI or URL for the first frame." },
+    endImage: { type: "string", description: "Base64 data URI or URL for the last frame." },
+    referenceImages: {
+        type: "array",
+        items: { type: "object", properties: { image: { type: "string" }, label: { type: "string" } } },
+        description: "Array of reference images for style matching."
+    },
+    negativePrompt: { type: "string", description: "Elements to exclude from the video." },
+    dialogue: { type: "string", description: "Optional voiceover or dialogue." },
+    soundSuggestion: { type: "string", description: "Background music or sound effects." },
+    cameraMotion: { type: "string", description: "Camera motion instructions." },
+    ambientNoise: { type: "string", description: "Ambient sound description." },
+    language: { type: "string", description: "Voiceover language." },
+    timeDuration: { type: "string", description: "Video duration in seconds. Default is '4'." },
+    resolution: { type: "string", description: "Resolution (e.g., '720p', '1080p'). Default is '720p'." },
+    model: { type: "string", description: "Model slug (e.g., 'google/veo-3.1-fast', 'openrouter/wan-2.7')." },
+    aspectRatio: { type: "string", description: "Aspect ratio (e.g., '9:16', '16:9'). Default is '9:16'." },
+    generateAudio: { type: "boolean", description: "Whether to generate audio. Default is false." }
+};
+const GENERATE_PRODUCT_VIDEO_TOOL = {
+    name: "generate_product_video",
+    description: "Generates a product video. Asynchronous: returns a jobId. You MUST use check_video_job_status with the jobId to poll for completion. Automatically deducts credits.",
+    inputSchema: { type: "object", properties: COMMON_VIDEO_PROPERTIES }
+};
+const GENERATE_APPAREL_VIDEO_TOOL = {
+    name: "generate_apparel_video",
+    description: "Generates an apparel try-on video. Asynchronous: returns a jobId. You MUST use check_video_job_status with the jobId to poll for completion. Automatically deducts credits.",
+    inputSchema: { type: "object", properties: COMMON_VIDEO_PROPERTIES }
+};
+const GENERATE_FESTIVAL_VIDEO_TOOL = {
+    name: "generate_festival_video",
+    description: "Generates a festival or event video. Asynchronous: returns a jobId. You MUST use check_video_job_status with the jobId to poll for completion. Automatically deducts credits.",
+    inputSchema: { type: "object", properties: COMMON_VIDEO_PROPERTIES }
+};
+const GENERATE_JEWELRY_VIDEO_TOOL = {
+    name: "generate_jewelry_video",
+    description: "Generates a jewelry showcase video. Asynchronous: returns a jobId. You MUST use check_video_job_status with the jobId to poll for completion. Automatically deducts credits.",
+    inputSchema: { type: "object", properties: COMMON_VIDEO_PROPERTIES }
+};
+const GENERATE_LOGO_VIDEO_TOOL = {
+    name: "generate_logo_video",
+    description: "Generates a logo animation video. Asynchronous: returns a jobId. You MUST use check_video_job_status with the jobId to poll for completion. Automatically deducts credits.",
+    inputSchema: { type: "object", properties: COMMON_VIDEO_PROPERTIES }
+};
+const CHECK_JOB_STATUS_TOOL = {
+    name: "check_video_job_status",
+    description: "Checks the status of an asynchronous video generation job. Call this repeatedly (e.g. every 10-30 seconds) until the job status is 'completed' or 'failed'.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            jobId: { type: "string", description: "The ID of the job to check." }
+        },
+        required: ["jobId"]
+    }
+};
 // ─── Tool Registration ─────────────────────────────────────────────────────────
 server.setRequestHandler(ListToolsRequestSchema, async () => {
     return {
@@ -157,6 +247,12 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             GENERATE_LOGO_TOOL,
             GENERATE_QR_CODE_TOOL,
             GENERATE_QR_CODE_SIMPLE_TOOL,
+            GENERATE_PRODUCT_VIDEO_TOOL,
+            GENERATE_APPAREL_VIDEO_TOOL,
+            GENERATE_FESTIVAL_VIDEO_TOOL,
+            GENERATE_JEWELRY_VIDEO_TOOL,
+            GENERATE_LOGO_VIDEO_TOOL,
+            CHECK_JOB_STATUS_TOOL,
         ],
     };
 });
@@ -242,6 +338,53 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 content: [{ type: "text", text: `✅ QR Code generated. Result: ${JSON.stringify(response.data).substring(0, 500)}` }],
             };
         }
+        // ── Video Generation (Asynchronous) ──────────────────────────────────────
+        const videoEndpoints = {
+            generate_product_video: '/product-video-generation',
+            generate_apparel_video: '/apparel-video-generation',
+            generate_festival_video: '/festival-video-generation',
+            generate_jewelry_video: '/jewelry-video-generation',
+            generate_logo_video: '/logo-video-generation'
+        };
+        if (videoEndpoints[name]) {
+            const response = await apiClient(videoEndpoints[name], {
+                method: 'POST',
+                body: JSON.stringify(args),
+            });
+            const result = response.data || response;
+            if (result?.jobId) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `✅ Job created successfully!\nJob ID: ${result.jobId}\nMessage: ${result.message}\n\nPlease use the check_video_job_status tool with this Job ID to poll for the result. Wait about 10-30 seconds between polls. Video generation can take several minutes.`
+                        }]
+                };
+            }
+            return { content: [{ type: "text", text: `Job started. Result: ${JSON.stringify(result).substring(0, 500)}` }] };
+        }
+        // ── Check Job Status ─────────────────────────────────────────────────────
+        if (name === 'check_video_job_status') {
+            const { jobId } = args;
+            const response = await apiClient(`/jobs/status?jobId=${encodeURIComponent(jobId)}`, {
+                method: 'GET',
+            });
+            const result = response.data || response;
+            if (result?.job) {
+                const job = result.job;
+                let text = `Job Status: ${job.status}\nProgress: ${job.progress}%\nStage: ${job.stage || 'N/A'}`;
+                if (job.status === 'completed' && job.result?.videoUrl) {
+                    text += `\n\n✅ Video generated successfully!\nVideo URL: ${job.result.videoUrl}`;
+                }
+                else if (job.status === 'failed') {
+                    text += `\n\n❌ Job failed: ${job.error || 'Unknown error'}`;
+                }
+                else {
+                    text += `\n\nJob is still running. Please check back again shortly.`;
+                }
+                return { content: [{ type: "text", text }] };
+            }
+            return { content: [{ type: "text", text: `Status check result: ${JSON.stringify(result).substring(0, 500)}` }] };
+        }
         throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
     }
     catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codingmantra/mcp-server",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "MCP Server for CodingMantra AI Tools",
   "type": "module",
   "bin": "build/index.js",

package/src/index.ts

@@ -55,6 +55,30 @@ const GENERATE_PRODUCT_PHOTO_TOOL = {
       referenceImage: {
         type: "string",
         description: "An optional URL or data URI of a reference image to guide style."
+      },
+      promptId: {
+        type: "string",
+        description: "Optional ID of a pre-defined prompt template."
+      },
+      logoImage: {
+        type: "string",
+        description: "Optional URL or Base64 data URI of a logo to place on the image."
+      },
+      logoPlacement: {
+        type: "string",
+        description: "Where to place the logo (e.g., 'top-left', 'bottom-right')."
+      },
+      logoSize: {
+        type: "number",
+        description: "Scale of the logo overlay (0.1 to 1.0)."
+      },
+      overlayText: {
+        type: "string",
+        description: "Optional text to overlay on the image."
+      },
+      marketingText: {
+        type: "string",
+        description: "Optional marketing text to overlay."
       }
     },
     required: ["productImages", "scenePrompt"]
@@ -102,6 +126,14 @@ const GENERATE_LOGO_TOOL = {
       resolution: {
         type: "string",
         description: "Output resolution (e.g., '1K', '2K'). Default is '1K'.",
+      },
+      promptId: {
+        type: "string",
+        description: "Optional ID or value of a pre-defined style template."
+      },
+      referenceImage: {
+        type: "string",
+        description: "An optional general style reference image URL or data URI."
       }
     },
     required: ["companyName", "stylePrompt"]
@@ -160,6 +192,71 @@ const GENERATE_QR_CODE_SIMPLE_TOOL = {
   }
 };
 
+const COMMON_VIDEO_PROPERTIES = {
+  prompt: { type: "string", description: "Detailed video description or prompt." },
+  mainImage: { type: "string", description: "Base64 data URI or URL for the main image (Image-to-Video mode)." },
+  startImage: { type: "string", description: "Base64 data URI or URL for the first frame." },
+  endImage: { type: "string", description: "Base64 data URI or URL for the last frame." },
+  referenceImages: { 
+    type: "array", 
+    items: { type: "object", properties: { image: { type: "string" }, label: { type: "string" } } },
+    description: "Array of reference images for style matching." 
+  },
+  negativePrompt: { type: "string", description: "Elements to exclude from the video." },
+  dialogue: { type: "string", description: "Optional voiceover or dialogue." },
+  soundSuggestion: { type: "string", description: "Background music or sound effects." },
+  cameraMotion: { type: "string", description: "Camera motion instructions." },
+  ambientNoise: { type: "string", description: "Ambient sound description." },
+  language: { type: "string", description: "Voiceover language." },
+  timeDuration: { type: "string", description: "Video duration in seconds. Default is '4'." },
+  resolution: { type: "string", description: "Resolution (e.g., '720p', '1080p'). Default is '720p'." },
+  model: { type: "string", description: "Model slug (e.g., 'google/veo-3.1-fast', 'openrouter/wan-2.7')." },
+  aspectRatio: { type: "string", description: "Aspect ratio (e.g., '9:16', '16:9'). Default is '9:16'." },
+  generateAudio: { type: "boolean", description: "Whether to generate audio. Default is false." }
+};
+
+const GENERATE_PRODUCT_VIDEO_TOOL = {
+  name: "generate_product_video",
+  description: "Generates a product video. Asynchronous: returns a jobId. You MUST use check_video_job_status with the jobId to poll for completion. Automatically deducts credits.",
+  inputSchema: { type: "object" as const, properties: COMMON_VIDEO_PROPERTIES }
+};
+
+const GENERATE_APPAREL_VIDEO_TOOL = {
+  name: "generate_apparel_video",
+  description: "Generates an apparel try-on video. Asynchronous: returns a jobId. You MUST use check_video_job_status with the jobId to poll for completion. Automatically deducts credits.",
+  inputSchema: { type: "object" as const, properties: COMMON_VIDEO_PROPERTIES }
+};
+
+const GENERATE_FESTIVAL_VIDEO_TOOL = {
+  name: "generate_festival_video",
+  description: "Generates a festival or event video. Asynchronous: returns a jobId. You MUST use check_video_job_status with the jobId to poll for completion. Automatically deducts credits.",
+  inputSchema: { type: "object" as const, properties: COMMON_VIDEO_PROPERTIES }
+};
+
+const GENERATE_JEWELRY_VIDEO_TOOL = {
+  name: "generate_jewelry_video",
+  description: "Generates a jewelry showcase video. Asynchronous: returns a jobId. You MUST use check_video_job_status with the jobId to poll for completion. Automatically deducts credits.",
+  inputSchema: { type: "object" as const, properties: COMMON_VIDEO_PROPERTIES }
+};
+
+const GENERATE_LOGO_VIDEO_TOOL = {
+  name: "generate_logo_video",
+  description: "Generates a logo animation video. Asynchronous: returns a jobId. You MUST use check_video_job_status with the jobId to poll for completion. Automatically deducts credits.",
+  inputSchema: { type: "object" as const, properties: COMMON_VIDEO_PROPERTIES }
+};
+
+const CHECK_JOB_STATUS_TOOL = {
+  name: "check_video_job_status",
+  description: "Checks the status of an asynchronous video generation job. Call this repeatedly (e.g. every 10-30 seconds) until the job status is 'completed' or 'failed'.",
+  inputSchema: {
+    type: "object" as const,
+    properties: {
+      jobId: { type: "string", description: "The ID of the job to check." }
+    },
+    required: ["jobId"]
+  }
+};
+
 // ─── Tool Registration ─────────────────────────────────────────────────────────
 
 server.setRequestHandler(ListToolsRequestSchema, async () => {
@@ -169,6 +266,12 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       GENERATE_LOGO_TOOL,
       GENERATE_QR_CODE_TOOL,
       GENERATE_QR_CODE_SIMPLE_TOOL,
+      GENERATE_PRODUCT_VIDEO_TOOL,
+      GENERATE_APPAREL_VIDEO_TOOL,
+      GENERATE_FESTIVAL_VIDEO_TOOL,
+      GENERATE_JEWELRY_VIDEO_TOOL,
+      GENERATE_LOGO_VIDEO_TOOL,
+      CHECK_JOB_STATUS_TOOL,
     ],
   };
 });
@@ -263,6 +366,57 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       };
     }
 
+    // ── Video Generation (Asynchronous) ──────────────────────────────────────
+    const videoEndpoints: Record<string, string> = {
+      generate_product_video: '/product-video-generation',
+      generate_apparel_video: '/apparel-video-generation',
+      generate_festival_video: '/festival-video-generation',
+      generate_jewelry_video: '/jewelry-video-generation',
+      generate_logo_video: '/logo-video-generation'
+    };
+
+    if (videoEndpoints[name]) {
+      const response = await apiClient(videoEndpoints[name], {
+        method: 'POST',
+        body: JSON.stringify(args),
+      });
+
+      const result = response.data || response;
+      if (result?.jobId) {
+        return {
+          content: [{ 
+            type: "text", 
+            text: `✅ Job created successfully!\nJob ID: ${result.jobId}\nMessage: ${result.message}\n\nPlease use the check_video_job_status tool with this Job ID to poll for the result. Wait about 10-30 seconds between polls. Video generation can take several minutes.` 
+          }]
+        };
+      }
+      return { content: [{ type: "text", text: `Job started. Result: ${JSON.stringify(result).substring(0, 500)}` }] };
+    }
+
+    // ── Check Job Status ─────────────────────────────────────────────────────
+    if (name === 'check_video_job_status') {
+      const { jobId } = args as { jobId: string };
+      const response = await apiClient(`/jobs/status?jobId=${encodeURIComponent(jobId)}`, {
+        method: 'GET',
+      });
+
+      const result = response.data || response;
+      if (result?.job) {
+        const job = result.job;
+        let text = `Job Status: ${job.status}\nProgress: ${job.progress}%\nStage: ${job.stage || 'N/A'}`;
+        
+        if (job.status === 'completed' && job.result?.videoUrl) {
+          text += `\n\n✅ Video generated successfully!\nVideo URL: ${job.result.videoUrl}`;
+        } else if (job.status === 'failed') {
+          text += `\n\n❌ Job failed: ${job.error || 'Unknown error'}`;
+        } else {
+          text += `\n\nJob is still running. Please check back again shortly.`;
+        }
+        return { content: [{ type: "text", text }] };
+      }
+      return { content: [{ type: "text", text: `Status check result: ${JSON.stringify(result).substring(0, 500)}` }] };
+    }
+
     throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
   } catch (error: any) {
     return {