multi-app-mcp 1.0.0

package/README.md

@@ -0,0 +1,106 @@
+# Multi-App MCP Server
+
+Ek single MCP Server jo multiple apps ke saath kaam karta hai.
+
+## Structure
+
+```
+qr-mcp-server/
+├── index.js              ← MCP core (touch mat karo)
+├── plugins/
+│   └── quickreviewer.js  ← Quickreviewer ke tools
+├── .env.example          ← Environment variables template
+└── package.json
+```
+
+## Setup
+
+### 1. Install
+```bash
+npm install
+```
+
+### 2. .env banao
+```bash
+cp .env.example .env
+# Phir .env mein apni API URL daalo
+```
+
+### 3. Claude Desktop Config
+
+**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+**Mac:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "my-apps": {
+      "command": "node",
+      "args": ["C:/full/path/to/qr-mcp-server/index.js"],
+      "env": {
+        "QR_API_URL": "https://your-quickreviewer-domain.com"
+      }
+    }
+  }
+}
+```
+
+### 4. Claude Desktop restart karo ✅
+
+---
+
+## Nayi App Add Karna
+
+Sirf 3 steps:
+
+**Step 1** — Naya plugin banao: `plugins/app2.js`
+```js
+const APP2_URL = process.env.APP2_API_URL;
+
+export const tools = [
+  {
+    name: "app2_create_order",
+    description: "Create an order in App2",
+    inputSchema: {
+      type: "object",
+      properties: {
+        item: { type: "string", description: "Item name" },
+      },
+      required: ["item"],
+    },
+  },
+];
+
+export const handlers = {
+  app2_create_order: async ({ item }) => {
+    const res = await fetch(`${APP2_URL}/orders`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ item }),
+    });
+    const data = await res.json();
+    return { content: [{ type: "text", text: JSON.stringify(data) }] };
+  },
+};
+```
+
+**Step 2** — `index.js` mein import karo (sirf 2 lines):
+```js
+import { tools as app2Tools, handlers as app2Handlers } from "./plugins/app2.js";
+
+const allTools    = [...qrTools, ...app2Tools];
+const allHandlers = { ...qrHandlers, ...app2Handlers };
+```
+
+**Step 3** — `.env` mein URL add karo:
+```
+APP2_API_URL=https://your-app2-domain.com
+```
+
+---
+
+## Available Tools
+
+| Tool | App | Description |
+|------|-----|-------------|
+| `qr_register_user` | Quickreviewer | Naya user register karo |

package/index.js

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+
+import { tools as qrTools, handlers as qrHandlers } from "./plugins/quickreviewer/index.js";
+
+// ─────────────────────────────────────────────────────────────────────────────
+// PLUGIN REGISTRY
+// Nayi app add karni ho to bas yahan 2 lines add karo:
+//   import { tools as app2Tools, handlers as app2Handlers } from "./plugins/app2.js";
+//   allTools push, allHandlers spread
+// ─────────────────────────────────────────────────────────────────────────────
+
+const allTools    = [...qrTools];
+const allHandlers = { ...qrHandlers };
+
+// ─── MCP Server Setup ─────────────────────────────────────────────────────────
+const server = new Server(
+  { name: "multi-app-mcp", version: "1.0.0" },
+  { capabilities: { tools: {} } }
+);
+
+// Claude poochta hai: "kya kya kar sakte ho?"
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: allTools,
+}));
+
+// Claude ek tool call karta hai
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+
+  const handler = allHandlers[name];
+
+  if (!handler) {
+    return {
+      content: [{ type: "text", text: `❌ Unknown tool: "${name}"` }],
+      isError: true,
+    };
+  }
+
+  try {
+    return await handler(args);
+  } catch (err) {
+    return {
+      content: [{ type: "text", text: `❌ Error in tool "${name}": ${err.message}` }],
+      isError: true,
+    };
+  }
+});
+
+// ─── Start Server ─────────────────────────────────────────────────────────────
+const transport = new StdioServerTransport();
+await server.connect(transport);
+console.error("✅ Multi-App MCP Server running...");

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "multi-app-mcp",
+  "version": "1.0.0",
+  "description": "Single MCP Server for multiple apps",
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "multi-app-mcp": "./index.js"
+  },
+  "files": [
+    "index.js",
+    "plugins/"
+  ],
+  "scripts": {
+    "start": "node index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  }
+}

package/plugins/quickreviewer/auth.js

@@ -0,0 +1,478 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// AUTH — Register, Login, Logout, Password tools
+// ─────────────────────────────────────────────────────────────────────────────
+
+import { session, getAuthHeaders, requireLogin } from "./session.js";
+
+const QR_API_URL = process.env.QR_API_URL || "https://app.quickreviewer.com/api";
+
+const b64 = (str) => Buffer.from(str).toString("base64");
+
+// ─── Tool Definitions ─────────────────────────────────────────────────────────
+
+export const tools = [
+  {
+    name: "qr_register_user",
+    description:
+      "Register a new user in Quickreviewer. " +
+      "Ask for userName, userEmail, and userPassword if not provided. " +
+      "promoCode is optional.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        userName:     { type: "string", description: "Full name of the user" },
+        userEmail:    { type: "string", description: "Email address of the user" },
+        userPassword: { type: "string", description: "Password (min 6 characters)" },
+        promoCode:    { type: "string", description: "Optional promo code" },
+      },
+      required: ["userName", "userEmail", "userPassword"],
+    },
+  },
+  {
+    name: "qr_login",
+    description:
+      "Login to Quickreviewer with email and password. " +
+      "Saves the auth token in memory so other tools work automatically. " +
+      "Call this first before using any other QR tool.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        userEmail:    { type: "string", description: "Registered email address" },
+        userPassword: { type: "string", description: "Account password" },
+      },
+      required: ["userEmail", "userPassword"],
+    },
+  },
+  {
+    name: "qr_logout",
+    description: "Logout from Quickreviewer. Clears the saved auth token from memory.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: [],
+    },
+  },
+  {
+    name: "qr_forgot_password",
+    description:
+      "Send a password reset email to the given email address. " +
+      "User does not need to be logged in.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        userEmail: { type: "string", description: "Email address to send reset link to" },
+      },
+      required: ["userEmail"],
+    },
+  },
+  {
+    name: "qr_resend_verification_code",
+    description:
+      "Resend the email verification code to the user's email. " +
+      "Useful if the user did not receive the code after registration.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        email: { type: "string", description: "Email address to resend the code to" },
+      },
+      required: ["email"],
+    },
+  },
+  {
+    name: "qr_validate_verification_code",
+    description:
+      "Validate the email verification code sent after registration. " +
+      "Provide the email and the code received.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        email: { type: "string", description: "Email address of the user" },
+        code:  { type: "string", description: "Verification code received via email" },
+      },
+      required: ["email", "code"],
+    },
+  },
+  {
+    name: "qr_change_password",
+    description:
+      "Change the password of the currently logged-in user. " +
+      "Requires the current password and the new password. " +
+      "User must be logged in first.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        currentPassword: { type: "string", description: "Current account password" },
+        userPassword:    { type: "string", description: "New password (min 6 characters)" },
+      },
+      required: ["currentPassword", "userPassword"],
+    },
+  },
+  {
+    name: "qr_get_storage",
+    description:
+      "Check storage usage of the logged-in user's Quickreviewer account. " +
+      "Returns used space, total space, and usage percentage. " +
+      "User must be logged in.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: [],
+    },
+  },
+  {
+    name: "qr_send_feedback",
+    description:
+      "Send feedback or a support request to Quickreviewer. " +
+      "ALWAYS ask for BOTH fields before calling this tool: " +
+      "1) subject — a short title for the feedback, " +
+      "2) comment — the detailed message. " +
+      "Do NOT call this tool until both subject and comment are provided by the user. " +
+      "User must be logged in.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        subject: { type: "string", description: "Subject of the feedback or support request" },
+        comment: { type: "string", description: "Detailed message or feedback" },
+      },
+      required: ["subject", "comment"],
+    },
+  },
+  {
+    name: "qr_get_notifications",
+    description:
+      "Get notifications for the logged-in user from Quickreviewer. " +
+      "Returns 10 notifications per page, sorted newest first. " +
+      "To get all notifications keep fetching next pages until no more results. " +
+      "User must be logged in.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        page: { type: "integer", description: "Page number (start from 1)" },
+      },
+      required: ["page"],
+    },
+  },
+];
+
+// ─── Handlers ─────────────────────────────────────────────────────────────────
+
+export const handlers = {
+
+  qr_register_user: async ({ userName, userEmail, userPassword, promoCode }) => {
+    const body = { userName, userEmail, userPassword };
+    if (promoCode) body.promoCode = promoCode;
+
+    const res  = await fetch(`${QR_API_URL}/signup`, {
+      method:  "POST",
+      headers: getAuthHeaders(),
+      body:    JSON.stringify(body),
+    });
+    const data = await res.json();
+
+    if (res.ok) {
+      return {
+        content: [{
+          type: "text",
+          text:
+            `✅ User registered successfully!\n\n` +
+            `Name:  ${userName}\n` +
+            `Email: ${userEmail}\n\n` +
+            `API Response:\n${JSON.stringify(data, null, 2)}`,
+        }],
+      };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `❌ Registration failed (HTTP ${res.status})\n\n${JSON.stringify(data, null, 2)}`,
+      }],
+      isError: true,
+    };
+  },
+
+  qr_login: async ({ userEmail, userPassword }) => {
+    const res  = await fetch(`${QR_API_URL}/login`, {
+      method:  "POST",
+      headers: getAuthHeaders(),
+      body:    JSON.stringify({ userEmail, userPassword: b64(userPassword) }),
+    });
+
+    const rawText = await res.text();
+    let data;
+    try {
+      data = JSON.parse(rawText);
+    } catch {
+      return {
+        content: [{
+          type: "text",
+          text:
+            `❌ Server returned non-JSON response (HTTP ${res.status})\n\n` +
+            `API URL: ${QR_API_URL}/login\n\n` +
+            `Raw Response:\n${rawText.slice(0, 500)}`,
+        }],
+        isError: true,
+      };
+    }
+
+    if (res.ok) {
+      session.token     = data.accessToken || data.token || null;
+      session.userId    = data.userId || null;
+      session.userName  = data.displayName || data.userName || null;
+      session.userEmail = userEmail;
+
+      return {
+        content: [{
+          type: "text",
+          text:
+            `✅ Logged in successfully!\n\n` +
+            `Email: ${userEmail}\n` +
+            `Token saved — other tools are ready to use.\n\n` +
+            `API Response:\n${JSON.stringify(data, null, 2)}`,
+        }],
+      };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `❌ Login failed (HTTP ${res.status})\n\n${JSON.stringify(data, null, 2)}`,
+      }],
+      isError: true,
+    };
+  },
+
+  qr_logout: async () => {
+    if (!session.token) {
+      return { content: [{ type: "text", text: "⚠️ You are not logged in." }] };
+    }
+
+    const res  = await fetch(`${QR_API_URL}/logout`, {
+      method:  "GET",
+      headers: getAuthHeaders(),
+    });
+    const data = await res.json().catch(() => ({}));
+
+    const loggedOutEmail  = session.userEmail;
+    session.token         = null;
+    session.userId        = null;
+    session.userName      = null;
+    session.userEmail     = null;
+
+    if (res.ok) {
+      return {
+        content: [{ type: "text", text: `✅ Logged out successfully!\n\nEmail: ${loggedOutEmail}` }],
+      };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `⚠️ API error but session cleared.\n\nHTTP ${res.status}: ${JSON.stringify(data, null, 2)}`,
+      }],
+    };
+  },
+
+  qr_forgot_password: async ({ userEmail }) => {
+    const res  = await fetch(`${QR_API_URL}/forgot-password`, {
+      method:  "POST",
+      headers: getAuthHeaders(),
+      body:    JSON.stringify({ userEmail }),
+    });
+    const data = await res.json();
+
+    if (res.ok) {
+      return {
+        content: [{
+          type: "text",
+          text: `✅ Password reset email sent!\n\nEmail: ${userEmail}\nPlease check your inbox.`,
+        }],
+      };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `❌ Failed (HTTP ${res.status})\n\n${JSON.stringify(data, null, 2)}`,
+      }],
+      isError: true,
+    };
+  },
+
+  qr_resend_verification_code: async ({ email }) => {
+    const res  = await fetch(`${QR_API_URL}/resend-verification-code`, {
+      method:  "POST",
+      headers: getAuthHeaders(),
+      body:    JSON.stringify({ email }),
+    });
+    const data = await res.json();
+
+    if (res.ok) {
+      return {
+        content: [{ type: "text", text: `✅ Verification code resent!\n\nEmail: ${email}` }],
+      };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `❌ Failed (HTTP ${res.status})\n\n${JSON.stringify(data, null, 2)}`,
+      }],
+      isError: true,
+    };
+  },
+
+  qr_validate_verification_code: async ({ email, code }) => {
+    const res  = await fetch(`${QR_API_URL}/validate-verification-code`, {
+      method:  "POST",
+      headers: getAuthHeaders(),
+      body:    JSON.stringify({ email, code }),
+    });
+    const data = await res.json();
+
+    if (res.ok) {
+      return {
+        content: [{
+          type: "text",
+          text: `✅ Email verified successfully!\n\nEmail: ${email}\nYour account is now active.`,
+        }],
+      };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `❌ Verification failed (HTTP ${res.status})\n\n${JSON.stringify(data, null, 2)}`,
+      }],
+      isError: true,
+    };
+  },
+
+  qr_change_password: async ({ currentPassword, userPassword }) => {
+    const authError = requireLogin();
+    if (authError) return authError;
+
+    if (!currentPassword || !userPassword) {
+      return {
+        content: [{
+          type: "text",
+          text:
+            `❌ Both fields are required to change password:\n\n` +
+            `- currentPassword: ${currentPassword ? "✅ provided" : "❌ missing"}\n` +
+            `- userPassword (new): ${userPassword ? "✅ provided" : "❌ missing"}\n\n` +
+            `Please provide both the current and new password.`,
+        }],
+        isError: true,
+      };
+    }
+
+    const res  = await fetch(`${QR_API_URL}/change-password`, {
+      method:  "POST",
+      headers: getAuthHeaders(),
+      body:    JSON.stringify({ currentPassword: b64(currentPassword), userPassword: b64(userPassword) }),
+    });
+    const data = await res.json();
+
+    if (res.ok) {
+      return {
+        content: [{ type: "text", text: `✅ Password changed successfully!` }],
+      };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `❌ Failed (HTTP ${res.status})\n\n${JSON.stringify(data, null, 2)}`,
+      }],
+      isError: true,
+    };
+  },
+
+  qr_send_feedback: async ({ subject, comment }) => {
+    const authError = requireLogin();
+    if (authError) return authError;
+
+    const res  = await fetch(`${QR_API_URL}/feedback`, {
+      method:  "POST",
+      headers: getAuthHeaders(),
+      body:    JSON.stringify({ subject, comment }),
+    });
+    const data = await res.json().catch(() => ({}));
+
+    if (res.ok) {
+      return {
+        content: [{
+          type: "text",
+          text:
+            `✅ Feedback sent successfully!\n\n` +
+            `Subject: ${subject}\n` +
+            `Message: ${comment}`,
+        }],
+      };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `❌ Failed (HTTP ${res.status})\n\n${JSON.stringify(data, null, 2)}`,
+      }],
+      isError: true,
+    };
+  },
+
+  qr_get_notifications: async ({ page = 1 }) => {
+    const authError = requireLogin();
+    if (authError) return authError;
+
+    const res  = await fetch(`${QR_API_URL}/notification-list`, {
+      method:  "POST",
+      headers: getAuthHeaders(),
+      body:    JSON.stringify({ page }),
+    });
+    const data = await res.json();
+
+    if (res.ok) {
+      const rows = data.rows || data || [];
+      const count = Array.isArray(rows) ? rows.length : 0;
+      return {
+        content: [{
+          type: "text",
+          text:
+            `✅ Notifications fetched — Page ${page} (${count} results)\n\n` +
+            `${JSON.stringify(data, null, 2)}`,
+        }],
+      };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `❌ Failed (HTTP ${res.status})\n\n${JSON.stringify(data, null, 2)}`,
+      }],
+      isError: true,
+    };
+  },
+
+  qr_get_storage: async () => {
+    const authError = requireLogin();
+    if (authError) return authError;
+
+    const res  = await fetch(`${QR_API_URL}/storage`, {
+      method:  "GET",
+      headers: getAuthHeaders(),
+    });
+    const data = await res.json();
+
+    if (res.ok) {
+      return {
+        content: [{
+          type: "text",
+          text:
+            `✅ Storage info fetched!\n\n` +
+            `Used:       ${data.usedSpace}\n` +
+            `Total:      ${data.totalSpace}\n` +
+            `Usage:      ${data.usedPercentage}%`,
+        }],
+      };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `❌ Failed (HTTP ${res.status})\n\n${JSON.stringify(data, null, 2)}`,
+      }],
+      isError: true,
+    };
+  },
+
+};