@codingmantra/mcp-server 0.1.3 → 0.2.0

package/package.json

@@ -1,21 +1,30 @@
 {
   "name": "@codingmantra/mcp-server",
-  "version": "0.1.3",
-  "description": "MCP Server for CodingMantra AI Tools",
+  "version": "0.2.0",
+  "description": "Official Model Context Protocol (MCP) Server for CodingMantra AI Generation Tools",
   "type": "module",
-  "bin": "build/index.js",
+  "main": "build/index.js",
+  "bin": {
+    "codingmantra-mcp": "build/index.js",
+    "mcp-server": "build/index.js"
+  },
+  "files": [
+    "build",
+    "README.md"
+  ],
   "scripts": {
     "build": "tsc",
+    "prepublishOnly": "npm run build",
     "start": "node build/index.js",
     "dev": "tsc --watch"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.1",
-    "dotenv": "^16.4.5",
+    "dotenv": "17.4.2",
     "zod": "^3.23.8"
   },
   "devDependencies": {
-    "@types/node": "26.2.0",
+    "@types/node": "26.4.1",
     "typescript": "^5.4.5"
   }
 }

package/src/api-client.ts

@@ -1,47 +0,0 @@
-import dotenv from 'dotenv';
-dotenv.config();
-
-const API_KEY = process.env.CODINGMANTRA_API_KEY;
-const API_BASE_URL = process.env.CODINGMANTRA_API_URL || 'https://codingmantra.com/api';
-
-if (!API_KEY) {
-  console.error('CRITICAL: CODINGMANTRA_API_KEY environment variable is missing.');
-  console.error('Please set it in your environment or .env file before running this server.');
-  process.exit(1);
-}
-
-/**
- * Helper to make authenticated requests to the CodingMantra API.
- */
-export async function apiClient(endpoint: string, options: RequestInit = {}) {
-  const url = `${API_BASE_URL}${endpoint.startsWith('/') ? endpoint : `/${endpoint}`}`;
-  
-  const headers = new Headers(options.headers || {});
-  headers.set('Authorization', `Bearer ${API_KEY}`);
-  
-  if (!(options.body instanceof FormData)) {
-      headers.set('Content-Type', 'application/json');
-  }
-
-  const response = await fetch(url, {
-    ...options,
-    headers,
-  });
-
-  if (!response.ok) {
-    let errorMsg = `API request failed with status ${response.status} ${response.statusText}`;
-    try {
-      const errorData = await response.json();
-      if (errorData?.error?.message) {
-        errorMsg += `: ${errorData.error.message}`;
-      } else {
-        errorMsg += `: ${JSON.stringify(errorData)}`;
-      }
-    } catch {
-      errorMsg += `: ${await response.text()}`;
-    }
-    throw new Error(errorMsg);
-  }
-
-  return response.json();
-}

package/src/index.ts

@@ -1,440 +0,0 @@
-#!/usr/bin/env node
-
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema, ErrorCode, McpError } from "@modelcontextprotocol/sdk/types.js";
-import { apiClient } from './api-client.js';
-
-const server = new Server(
-  {
-    name: "codingmantra-mcp",
-    version: "0.1.0",
-  },
-  {
-    capabilities: {
-      tools: {},
-    },
-  }
-);
-
-// ─── Tool Definitions ──────────────────────────────────────────────────────────
-
-const GENERATE_PRODUCT_PHOTO_TOOL = {
-  name: "generate_product_photo",
-  description: "Generates an AI product photography image with a specific scene prompt. Automatically deducts credits from your CodingMantra account. Returns the generated image directly (synchronous).",
-  inputSchema: {
-    type: "object" as const,
-    properties: {
-      productImages: {
-        type: "array",
-        items: {
-          type: "object",
-          properties: {
-            url: { type: "string", description: "Public URL of the product image." },
-            dataUrl: { type: "string", description: "Base64 data URI of the product image." }
-          }
-        },
-        description: "Array of product images. Each must have either a 'url' or 'dataUrl'. At least one required."
-      },
-      scenePrompt: {
-        type: "string",
-        description: "A detailed description of the background scene and setting for the product photo."
-      },
-      model: {
-        type: "string",
-        description: "The AI model slug (e.g., 'pro', 'standard', 'flash'). Default is 'pro'.",
-      },
-      resolution: {
-        type: "string",
-        description: "Output resolution (e.g., '1K', '2K', '4K'). Default is '1K'.",
-      },
-      aspectRatio: {
-        type: "string",
-        description: "Output aspect ratio (e.g., '1:1', '16:9', '9:16'). Default is '1:1'.",
-      },
-      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"]
-  }
-};
-
-const GENERATE_LOGO_TOOL = {
-  name: "generate_logo",
-  description: "Generates an AI brand logo. Requires a company name and style description. Automatically deducts credits from your CodingMantra account. Returns the generated logo directly (synchronous).",
-  inputSchema: {
-    type: "object" as const,
-    properties: {
-      companyName: {
-        type: "string",
-        description: "The company or brand name to feature in the logo."
-      },
-      stylePrompt: {
-        type: "string",
-        description: "A detailed style description for the logo (e.g., 'minimalist flat vector logo, dark blue and gold color scheme, modern tech feel')."
-      },
-      subtitle: {
-        type: "string",
-        description: "An optional subtitle or tagline."
-      },
-      industry: {
-        type: "string",
-        description: "The industry the company operates in (e.g., 'Technology', 'Food & Beverage')."
-      },
-      ideas: {
-        type: "string",
-        description: "User-provided ideas, keywords, or concepts for the logo."
-      },
-      colors: {
-        type: "string",
-        description: "Preferred color palette description (e.g., 'blue and silver', '#FF5733 and white')."
-      },
-      aspectRatio: {
-        type: "string",
-        description: "Output aspect ratio. Default is '1:1'.",
-      },
-      modelId: {
-        type: "string",
-        description: "The image model ID. Default uses the platform default.",
-      },
-      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"]
-  }
-};
-
-const GENERATE_QR_CODE_TOOL = {
-  name: "generate_qr_code",
-  description: "Generates a QR code for a given text, URL, WiFi, email, vCard, or UPI payment. Returns a base64 encoded image data URI. Supports customization of colors, size, error correction level, and optional logo overlay.",
-  inputSchema: {
-    type: "object" as const,
-    properties: {
-      type: {
-        type: "string",
-        enum: ["url", "text", "wifi", "email", "vcard", "upi"],
-        description: "The type of QR code to generate."
-      },
-      value: {
-        type: "string",
-        description: "The text or URL to encode (required for 'url' and 'text' types)."
-      },
-      size: {
-        type: "number",
-        description: "QR code size in pixels (50-2048). Default is 512."
-      },
-      fgColor: {
-        type: "string",
-        description: "Foreground color as hex (e.g., '#000000'). Default is black."
-      },
-      bgColor: {
-        type: "string",
-        description: "Background color as hex (e.g., '#FFFFFF'). Default is white."
-      },
-      level: {
-        type: "string",
-        enum: ["L", "M", "Q", "H"],
-        description: "Error correction level. Default is 'L'."
-      }
-    },
-    required: ["type", "value"]
-  }
-};
-
-const GENERATE_QR_CODE_SIMPLE_TOOL = {
-  name: "generate_qr_code_simple",
-  description: "Quick QR code generation from plain text or URL. Uses a simple GET-based endpoint. Returns a base64 encoded QR code image.",
-  inputSchema: {
-    type: "object" as const,
-    properties: {
-      text: {
-        type: "string",
-        description: "The text or URL to encode in the QR code."
-      }
-    },
-    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" 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 () => {
-  return {
-    tools: [
-      GENERATE_PRODUCT_PHOTO_TOOL,
-      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,
-    ],
-  };
-});
-
-// ─── Tool Execution ─────────────────────────────────────────────────────────────
-
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-  try {
-    const { name, arguments: args } = request.params;
-
-    // ── Product Photography (synchronous) ────────────────────────────────────
-    if (name === 'generate_product_photo') {
-      const response = await apiClient('/image/product-photography', {
-        method: 'POST',
-        body: JSON.stringify(args),
-      });
-
-      const result = response.data;
-      let text = '✅ Product photo generated successfully!\n\n';
-
-      if (result?.imageUrl) {
-        text += `Image URL: ${result.imageUrl}`;
-      } else if (result?.photoDataUri) {
-        text += `Image data returned (base64). Length: ${String(result.photoDataUri).length} characters.\nData URI: ${String(result.photoDataUri).substring(0, 100)}...`;
-      } else if (result?.output) {
-        text += `Image data returned (base64). Length: ${String(result.output).length} characters.`;
-      } else {
-        text += `Result: ${JSON.stringify(result).substring(0, 500)}`;
-      }
-
-      return { content: [{ type: "text", text }] };
-    }
-
-    // ── Logo Creator (synchronous) ───────────────────────────────────────────
-    if (name === 'generate_logo') {
-      const response = await apiClient('/image/logo-creator', {
-        method: 'POST',
-        body: JSON.stringify(args),
-      });
-
-      const result = response.data;
-      let text = '✅ Logo generated successfully!\n\n';
-
-      if (result?.imageUrl) {
-        text += `Image URL: ${result.imageUrl}`;
-      } else if (result?.photoDataUri) {
-        text += `Image data returned (base64). Length: ${String(result.photoDataUri).length} characters.\nData URI: ${String(result.photoDataUri).substring(0, 100)}...`;
-      } else if (result?.output) {
-        text += `Image data returned (base64). Length: ${String(result.output).length} characters.`;
-      } else {
-        text += `Result: ${JSON.stringify(result).substring(0, 500)}`;
-      }
-
-      return { content: [{ type: "text", text }] };
-    }
-
-    // ── QR Code (POST, full-featured) ────────────────────────────────────────
-    if (name === 'generate_qr_code') {
-      const response = await apiClient('/qr-code/generate', {
-        method: 'POST',
-        body: JSON.stringify(args),
-      });
-
-      const qrDataUrl = response.data?.qrCodeDataUrl;
-      if (qrDataUrl) {
-        return {
-          content: [{ type: "text", text: `✅ QR Code generated successfully!\n\nData URI: ${qrDataUrl}` }],
-        };
-      }
-      return {
-        content: [{ type: "text", text: `✅ QR Code generated. Result: ${JSON.stringify(response.data).substring(0, 500)}` }],
-      };
-    }
-
-    // ── QR Code Simple (GET, path-based — legacy/backward compatible) ────────
-    if (name === 'generate_qr_code_simple') {
-      const { text } = args as { text: string };
-      const encodedText = encodeURIComponent(text);
-      const apiKey = process.env.CODINGMANTRA_API_KEY;
-      const response = await apiClient(`/qr-code/generate-base64/${apiKey}/${encodedText}`, {
-        method: 'GET',
-      });
-
-      const qrDataUrl = response.data?.qrCodeDataUrl;
-      if (qrDataUrl) {
-        return {
-          content: [{ type: "text", text: `✅ QR Code generated successfully!\n\nData URI: ${qrDataUrl}` }],
-        };
-      }
-      return {
-        content: [{ type: "text", text: `✅ QR Code generated. Result: ${JSON.stringify(response.data).substring(0, 500)}` }],
-      };
-    }
-
-    // ── 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 {
-      content: [{ type: "text", text: `❌ Error: ${error.message}` }],
-      isError: true,
-    };
-  }
-});
-
-// ─── Server Startup ─────────────────────────────────────────────────────────────
-
-async function run() {
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-  console.error("CodingMantra MCP Server running on stdio");
-}
-
-run().catch((error) => {
-  console.error("Fatal error running server:", error);
-  process.exit(1);
-});

package/tsconfig.json

@@ -1,14 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "outDir": "./build",
-    "rootDir": "./src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true
-  },
-  "include": ["src/**/*"]
-}