@insforge/mcp 1.1.7-dev.4 → 1.1.7-dev.6

package/dist/{chunk-BY5473FJ.js → chunk-Y75UHN6G.js}

@@ -735,10 +735,74 @@ var functionUpdateRequestSchema = z13.object({
 
 // src/shared/tools.ts
 import FormData from "form-data";
+var TOOL_VERSION_REQUIREMENTS = {
+  "upsert-schedule": "1.1.1",
+  // 'get-schedules': '1.1.1',
+  // 'get-schedule-logs': '1.1.1',
+  "delete-schedule": "1.1.1"
+};
 function registerInsforgeTools(server, config = {}) {
   const GLOBAL_API_KEY = config.apiKey || process.env.API_KEY || "";
   const API_BASE_URL = config.apiBaseUrl || process.env.API_BASE_URL || "http://localhost:7130";
   const usageTracker = new UsageTracker(API_BASE_URL, GLOBAL_API_KEY);
+  let versionCache = null;
+  const VERSION_CACHE_TTL = 5 * 60 * 1e3;
+  async function getBackendVersion() {
+    const now = Date.now();
+    if (versionCache && now - versionCache.timestamp < VERSION_CACHE_TTL) {
+      return versionCache.version;
+    }
+    try {
+      const response = await fetch2(`${API_BASE_URL}/api/health`, {
+        method: "GET",
+        headers: {
+          "Content-Type": "application/json"
+        }
+      });
+      if (!response.ok) {
+        throw new Error(`Health check failed with status ${response.status}`);
+      }
+      const health = await response.json();
+      versionCache = {
+        version: health.version,
+        timestamp: now
+      };
+      return health.version;
+    } catch (error) {
+      const errMsg = error instanceof Error ? error.message : "Unknown error";
+      throw new Error(`Failed to fetch backend version: ${errMsg}`);
+    }
+  }
+  function compareVersions(v1, v2) {
+    const parts1 = v1.split(".").map(Number);
+    const parts2 = v2.split(".").map(Number);
+    for (let i = 0; i < Math.max(parts1.length, parts2.length); i++) {
+      const part1 = parts1[i] || 0;
+      const part2 = parts2[i] || 0;
+      if (part1 > part2) return 1;
+      if (part1 < part2) return -1;
+    }
+    return 0;
+  }
+  async function checkToolVersion(toolName) {
+    const requiredVersion = TOOL_VERSION_REQUIREMENTS[toolName];
+    if (!requiredVersion) {
+      return;
+    }
+    try {
+      const currentVersion = await getBackendVersion();
+      if (compareVersions(currentVersion, requiredVersion) < 0) {
+        throw new Error(
+          `Tool '${toolName}' requires backend version ${requiredVersion} or higher, but current version is ${currentVersion}. Please upgrade your Insforge backend server.`
+        );
+      }
+    } catch (error) {
+      if (error instanceof Error && error.message.includes("requires backend version")) {
+        throw error;
+      }
+      console.warn(`Warning: Could not verify backend version for tool '${toolName}': ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+  }
   async function trackToolUsage(toolName, success = true) {
     if (GLOBAL_API_KEY) {
       await usageTracker.trackUsage(toolName, success);
@@ -783,14 +847,14 @@ function registerInsforgeTools(server, config = {}) {
     }
   };
   server.tool(
-    "get-docs",
+    "fetch-docs",
     'Fetch Insforge documentation. Use "instructions" for essential backend setup (MANDATORY FIRST), or select specific SDK docs for database, auth, storage, functions, or AI integration.',
     {
-      docType: z14.enum(["instructions", "db-sdk", "auth-sdk", "storage-sdk", "functions-sdk", "ai-integration-sdk"]).describe(
-        'Documentation type: "instructions" (essential backend setup - use FIRST), "db-sdk" (database operations), "auth-sdk" (authentication), "storage-sdk" (file storage), "functions-sdk" (edge functions), "ai-integration-sdk" (AI features)'
+      docType: z14.enum(["instructions", "db-sdk", "auth-sdk", "storage-sdk", "functions-sdk", "ai-integration-sdk", "auth-components-nextjs"]).describe(
+        'Documentation type: "instructions" (essential backend setup - use FIRST), "db-sdk" (database operations), "auth-sdk" (authentication), "storage-sdk" (file storage), "functions-sdk" (edge functions), "ai-integration-sdk" (AI features), "auth-components-nextjs" (authentication components for Next.js applications)'
       )
     },
-    withUsageTracking("get-docs", async ({ docType }) => {
+    withUsageTracking("fetch-docs", async ({ docType }) => {
       try {
         const content = await fetchDocumentation(docType);
         return {
@@ -1356,12 +1420,20 @@ ${JSON.stringify(metadata, null, 2)}`
         const actualApiKey = getApiKey(apiKey);
         const queryParams = new URLSearchParams();
         if (limit) queryParams.append("limit", limit.toString());
-        const response = await fetch2(`${API_BASE_URL}/api/logs/analytics/${source}?${queryParams}`, {
+        let response = await fetch2(`${API_BASE_URL}/api/logs/${source}?${queryParams}`, {
           method: "GET",
           headers: {
             "x-api-key": actualApiKey
           }
         });
+        if (response.status === 404) {
+          response = await fetch2(`${API_BASE_URL}/api/logs/analytics/${source}?${queryParams}`, {
+            method: "GET",
+            headers: {
+              "x-api-key": actualApiKey
+            }
+          });
+        }
         const result = await handleApiResponse(response);
         return {
           content: [
@@ -1385,10 +1457,114 @@ ${JSON.stringify(metadata, null, 2)}`
       }
     })
   );
+  server.tool(
+    "upsert-schedule",
+    "Create or update a cron job schedule. If id is provided, updates existing schedule; otherwise creates a new one.",
+    {
+      apiKey: z14.string().optional().describe("API key for authentication (optional if provided via --api_key)"),
+      id: z14.string().uuid().optional().describe("The UUID of the schedule to update. If omitted, a new schedule will be created."),
+      name: z14.string().min(3).describe("Schedule name (at least 3 characters)"),
+      cronSchedule: z14.string().describe('Cron schedule format (5 or 6 parts, e.g., "0 */2 * * *" for every 2 hours)'),
+      functionUrl: z14.string().url().describe("The URL to call when the schedule triggers"),
+      httpMethod: z14.enum(["GET", "POST", "PUT", "PATCH", "DELETE"]).optional().default("POST").describe("HTTP method to use"),
+      headers: z14.record(z14.string()).optional().describe('HTTP headers. Values starting with "secret:" will be resolved from secrets store.'),
+      body: z14.record(z14.unknown()).optional().describe("JSON body to send with the request")
+    },
+    withUsageTracking("upsert-schedule", async ({ apiKey, id, name, cronSchedule, functionUrl, httpMethod, headers, body }) => {
+      try {
+        await checkToolVersion("upsert-schedule");
+        const actualApiKey = getApiKey(apiKey);
+        const requestBody = {
+          name,
+          cronSchedule,
+          functionUrl,
+          httpMethod: httpMethod || "POST"
+        };
+        if (id) {
+          requestBody.id = id;
+        }
+        if (headers) {
+          requestBody.headers = headers;
+        }
+        if (body) {
+          requestBody.body = body;
+        }
+        const response = await fetch2(`${API_BASE_URL}/api/schedules`, {
+          method: "POST",
+          headers: {
+            "x-api-key": actualApiKey,
+            "Content-Type": "application/json"
+          },
+          body: JSON.stringify(requestBody)
+        });
+        const result = await handleApiResponse(response);
+        const action = id ? "updated" : "created";
+        return await addBackgroundContext({
+          content: [
+            {
+              type: "text",
+              text: formatSuccessMessage(`Schedule '${name}' ${action} successfully`, result)
+            }
+          ]
+        });
+      } catch (error) {
+        const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
+        return await addBackgroundContext({
+          content: [
+            {
+              type: "text",
+              text: `Error upserting schedule: ${errMsg}`
+            }
+          ],
+          isError: true
+        });
+      }
+    })
+  );
+  server.tool(
+    "delete-schedule",
+    "Delete a cron job schedule permanently",
+    {
+      apiKey: z14.string().optional().describe("API key for authentication (optional if provided via --api_key)"),
+      scheduleId: z14.string().uuid().describe("The UUID of the schedule to delete")
+    },
+    withUsageTracking("delete-schedule", async ({ apiKey, scheduleId }) => {
+      try {
+        await checkToolVersion("delete-schedule");
+        const actualApiKey = getApiKey(apiKey);
+        const response = await fetch2(`${API_BASE_URL}/api/schedules/${scheduleId}`, {
+          method: "DELETE",
+          headers: {
+            "x-api-key": actualApiKey
+          }
+        });
+        const result = await handleApiResponse(response);
+        return await addBackgroundContext({
+          content: [
+            {
+              type: "text",
+              text: formatSuccessMessage(`Schedule ${scheduleId} deleted successfully`, result)
+            }
+          ]
+        });
+      } catch (error) {
+        const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
+        return await addBackgroundContext({
+          content: [
+            {
+              type: "text",
+              text: `Error deleting schedule: ${errMsg}`
+            }
+          ],
+          isError: true
+        });
+      }
+    })
+  );
   return {
     apiKey: GLOBAL_API_KEY,
     apiBaseUrl: API_BASE_URL,
-    toolCount: 14
+    toolCount: 16
   };
 }
 

package/dist/http-server.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   registerInsforgeTools
-} from "./chunk-BY5473FJ.js";
+} from "./chunk-Y75UHN6G.js";
 
 // src/http/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   registerInsforgeTools
-} from "./chunk-BY5473FJ.js";
+} from "./chunk-Y75UHN6G.js";
 
 // src/stdio/index.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";

package/mcp.json

@@ -1,7 +1,7 @@
-{
-  "$schema": "https://glama.ai/mcp/schemas/server.json",
-  "maintainers": [
-    "InsForge",
-    "tonychang04"
-  ]
-}
+{
+  "$schema": "https://glama.ai/mcp/schemas/server.json",
+  "maintainers": [
+    "InsForge",
+    "tonychang04"
+  ]
+}

package/package.json

@@ -1,53 +1,55 @@
-{
-  "name": "@insforge/mcp",
-  "version": "1.1.7-dev.4",
-  "description": "MCP (Model Context Protocol) server for Insforge backend-as-a-service",
-  "type": "module",
-  "main": "dist/index.js",
-  "bin": {
-    "insforge-mcp": "./dist/index.js"
-  },
-  "scripts": {
-    "dev:stdio": "tsx watch src/stdio/index.ts",
-    "dev:http": "tsx watch src/http/server.ts",
-    "build": "tsup",
-    "prepublishOnly": "npm run build"
-  },
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "insforge",
-    "backend-as-a-service"
-  ],
-  "author": "Insforge",
-  "license": "Apache-2.0",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/InsForge/insforge-mcp.git"
-  },
-  "homepage": "https://github.com/InsForge/insforge-mcp#readme",
-  "bugs": {
-    "url": "https://github.com/InsForge/insforge-mcp/issues"
-  },
-  "files": [
-    "dist",
-    "mcp.json"
-  ],
-  "dependencies": {
-    "@insforge/shared-schemas": "^1.1.7",
-    "@modelcontextprotocol/sdk": "^1.15.1",
-    "@types/express": "^5.0.3",
-    "commander": "^14.0.0",
-    "express": "^5.1.0",
-    "form-data": "^4.0.4",
-    "node-fetch": "^3.3.2",
-    "zod": "^3.23.8"
-  },
-  "devDependencies": {
-    "@types/node": "^20.10.5",
-    "rimraf": "^5.0.5",
-    "tsup": "^8.5.0",
-    "tsx": "^4.7.0",
-    "typescript": "^5.3.3"
-  }
-}
+{
+  "name": "@insforge/mcp",
+  "version": "1.1.7-dev.6",
+  "description": "MCP (Model Context Protocol) server for Insforge backend-as-a-service",
+  "mcpName": "io.github.InsForge/insforge-mcp",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "insforge-mcp": "./dist/index.js"
+  },
+  "scripts": {
+    "dev:stdio": "tsx watch src/stdio/index.ts",
+    "dev:http": "tsx watch src/http/server.ts",
+    "build": "tsup",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "insforge",
+    "backend-as-a-service"
+  ],
+  "author": "Insforge",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/InsForge/insforge-mcp.git"
+  },
+  "homepage": "https://github.com/InsForge/insforge-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/InsForge/insforge-mcp/issues"
+  },
+  "files": [
+    "dist",
+    "mcp.json",
+    "server.json"
+  ],
+  "dependencies": {
+    "@insforge/shared-schemas": "^1.1.7",
+    "@modelcontextprotocol/sdk": "^1.15.1",
+    "@types/express": "^5.0.3",
+    "commander": "^14.0.0",
+    "express": "^5.1.0",
+    "form-data": "^4.0.4",
+    "node-fetch": "^3.3.2",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.5",
+    "rimraf": "^5.0.5",
+    "tsup": "^8.5.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3"
+  }
+}

package/server.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-10-17/server.schema.json",
+  "name": "io.github.InsForge/insforge-mcp",
+  "title": "Insforge",
+  "description": "MCP server for Insforge BaaS - database, auth, storage, edge functions, and container logs",
+  "version": "1.1.5",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@insforge/mcp",
+      "version": "1.1.5",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}