@codingmantra/mcp-server 0.1.0

package/README.md

@@ -0,0 +1,65 @@
+# @codingmantra/mcp-server
+
+A **Model Context Protocol (MCP)** server that connects AI agents (like Claude Desktop, Cursor, and Cline) to CodingMantra's AI generation tools.
+
+## 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)
+
+## Setup
+
+### 1. Get an API Key
+
+Generate an API key from your [CodingMantra Dashboard → My API Keys](https://codingmantra.com/my-api).
+
+### 2. Configure Claude Desktop
+
+Add the following to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "codingmantra": {
+      "command": "npx",
+      "args": ["-y", "@codingmantra/mcp-server"],
+      "env": {
+        "CODINGMANTRA_API_KEY": "YOUR_API_KEY"
+      }
+    }
+  }
+}
+```
+
+### 3. Restart Claude Desktop
+
+After saving the config, restart Claude Desktop. You can now ask Claude to:
+
+- *"Generate a product photo of this watch on a marble surface"*
+- *"Create a minimalist logo for my company TechFlow"*
+- *"Generate a QR code for https://codingmantra.com"*
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run locally
+CODINGMANTRA_API_KEY=your_key npm start
+```
+
+## Environment Variables
+
+| Variable | Required | Description |
+|---|---|---|
+| `CODINGMANTRA_API_KEY` | ✅ | Your CodingMantra developer API key |
+| `CODINGMANTRA_API_URL` | ❌ | Custom API base URL (default: `https://codingmantra.com/api`) |
+
+## License
+
+Private — Part of the CodingMantra Web Portal.

package/build/api-client.js

@@ -0,0 +1,41 @@
+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, options = {}) {
+    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/build/index.js

@@ -0,0 +1,263 @@
+#!/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",
+        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."
+            }
+        },
+        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",
+        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'.",
+            }
+        },
+        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",
+        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",
+        properties: {
+            text: {
+                type: "string",
+                description: "The text or URL to encode in the QR code."
+            }
+        },
+        required: ["text"]
+    }
+};
+// ─── Tool Registration ─────────────────────────────────────────────────────────
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            GENERATE_PRODUCT_PHOTO_TOOL,
+            GENERATE_LOGO_TOOL,
+            GENERATE_QR_CODE_TOOL,
+            GENERATE_QR_CODE_SIMPLE_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;
+            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)}` }],
+            };
+        }
+        throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
+    }
+    catch (error) {
+        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/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@codingmantra/mcp-server",
+  "version": "0.1.0",
+  "description": "MCP Server for CodingMantra AI Tools",
+  "type": "module",
+  "bin": "build/index.js",
+  "scripts": {
+    "build": "tsc",
+    "start": "node build/index.js",
+    "dev": "tsc --watch"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.1",
+    "dotenv": "^16.4.5",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.5"
+  }
+}

package/src/api-client.ts

@@ -0,0 +1,47 @@
+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

@@ -0,0 +1,286 @@
+#!/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."
+      }
+    },
+    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'.",
+      }
+    },
+    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"]
+  }
+};
+
+// ─── Tool Registration ─────────────────────────────────────────────────────────
+
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  return {
+    tools: [
+      GENERATE_PRODUCT_PHOTO_TOOL,
+      GENERATE_LOGO_TOOL,
+      GENERATE_QR_CODE_TOOL,
+      GENERATE_QR_CODE_SIMPLE_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)}` }],
+      };
+    }
+
+    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

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