@insforge/mcp 1.1.7-dev.2 → 1.1.7-dev.20

package/dist/{chunk-74IVXADC.js → chunk-OLIGYXLN.js}

@@ -4,6 +4,8 @@
 import { z as z14 } from "zod";
 import fetch2 from "node-fetch";
 import { promises as fs } from "fs";
+import { exec } from "child_process";
+import { promisify } from "util";
 
 // src/shared/response-handler.ts
 async function handleApiResponse(response) {
@@ -161,8 +163,8 @@ var deleteTableResponse = z2.object({
 });
 var rawSQLRequestSchema = z2.object({
   query: z2.string().min(1, "Query is required"),
-  params: z2.array(z2.any()).optional()
-  // z.any() generates valid JSON Schema with items: {}
+  params: z2.array(z2.unknown()).optional()
+  // z.unknown() generates JSON Schema with items: {}
 });
 var rawSQLResponseSchema = z2.object({
   rows: z2.array(z2.record(z2.string(), z2.unknown())),
@@ -735,10 +737,75 @@ var functionUpdateRequestSchema = z13.object({
 
 // src/shared/tools.ts
 import FormData from "form-data";
+var execAsync = promisify(exec);
+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);
@@ -774,6 +841,7 @@ function registerInsforgeTools(server, config = {}) {
       if (result && typeof result === "object" && "content" in result) {
         let content = result.content;
         content = content.replace(/http:\/\/localhost:7130/g, API_BASE_URL);
+        content = content.replace(/https:\/\/your-app\.region\.insforge\.app/g, API_BASE_URL);
         return content;
       }
       throw new Error("Invalid response format from documentation endpoint");
@@ -783,12 +851,16 @@ function registerInsforgeTools(server, config = {}) {
     }
   };
   server.tool(
-    "get-instructions",
-    "Instruction Essential backend setup tool. <critical>MANDATORY: You MUST use this tool FIRST before attempting any backend operations. Contains required API endpoints, authentication details, and setup instructions.</critical>",
-    {},
-    withUsageTracking("get-instructions", async () => {
+    "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", "storage-sdk", "functions-sdk", "ai-integration-sdk", "auth-components-react", "auth-components-react-router"]).describe(
+        'Documentation type: "instructions" (essential backend setup - use FIRST), "db-sdk" (database operations), "storage-sdk" (file storage), "functions-sdk" (edge functions), "ai-integration-sdk" (AI features), "auth-components-react" (authentication components for React+Vite applications), "auth-components-react-router" (authentication components for React + React Router applications),'
+      )
+    },
+    withUsageTracking("fetch-docs", async ({ docType }) => {
       try {
-        const content = await fetchDocumentation("instructions");
+        const content = await fetchDocumentation(docType);
         return {
           content: [
             {
@@ -797,10 +869,62 @@ function registerInsforgeTools(server, config = {}) {
             }
           ]
         };
+      } catch (error) {
+        if (error instanceof Error && error.message.includes("404")) {
+          try {
+            const instructionsContent = await fetchDocumentation("instructions");
+            return {
+              content: [{ type: "text", text: instructionsContent }]
+            };
+          } catch (fallbackError) {
+            const fallbackErrMsg = fallbackError instanceof Error ? fallbackError.message : "Unknown error occurred";
+            return {
+              content: [{ type: "text", text: `Error fetching documentation: ${fallbackErrMsg}` }]
+            };
+          }
+        }
+        const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
+        return {
+          content: [{ type: "text", text: `Error fetching ${docType} documentation: ${errMsg}` }]
+        };
+      }
+    })
+  );
+  server.tool(
+    "get-anon-key",
+    "Generate an anonymous JWT token that never expires. Requires admin API key. Use this for client-side applications that need public access.",
+    {
+      apiKey: z14.string().optional().describe("API key for authentication (optional if provided via --api_key)")
+    },
+    withUsageTracking("get-anon-key", async ({ apiKey }) => {
+      try {
+        const actualApiKey = getApiKey(apiKey);
+        const response = await fetch2(`${API_BASE_URL}/api/auth/tokens/anon`, {
+          method: "POST",
+          headers: {
+            "x-api-key": actualApiKey,
+            "Content-Type": "application/json"
+          }
+        });
+        const result = await handleApiResponse(response);
+        return {
+          content: [
+            {
+              type: "text",
+              text: formatSuccessMessage("Anonymous token generated", result)
+            }
+          ]
+        };
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
         return {
-          content: [{ type: "text", text: `Error: ${errMsg}` }]
+          content: [
+            {
+              type: "text",
+              text: `Error generating anonymous token: ${errMsg}`
+            }
+          ],
+          isError: true
         };
       }
     })
@@ -929,9 +1053,73 @@ ${JSON.stringify(metadata, null, 2)}`
       }
     })
   );
+  server.tool(
+    "download-template",
+    "CRITICAL: MANDATORY FIRST STEP for all new InsForge projects. Download pre-configured starter template (React/Next.js/React Router). ALWAYS use this tool BEFORE any other setup when starting a new project.",
+    {
+      frame: z14.enum(["react"]).describe("Framework to use for the template (currently only React is supported)"),
+      projectName: z14.string().optional().describe('Name for the project directory (optional, defaults to "insforge-react")')
+    },
+    withUsageTracking("download-template", async ({ frame, projectName }) => {
+      try {
+        const response = await fetch2(`${API_BASE_URL}/api/auth/tokens/anon`, {
+          method: "POST",
+          headers: {
+            "x-api-key": getApiKey(),
+            "Content-Type": "application/json"
+          }
+        });
+        const result = await handleApiResponse(response);
+        const anonKey = result.accessToken;
+        if (!anonKey) {
+          throw new Error("Failed to retrieve anon key from backend");
+        }
+        const targetDir = projectName || `insforge-${frame}`;
+        const command = `npx create-insforge-app ${targetDir}  --frame ${frame} --base-url ${API_BASE_URL} --anon-key ${anonKey}`;
+        const { stdout, stderr } = await execAsync(command, {
+          maxBuffer: 10 * 1024 * 1024
+          // 10MB buffer
+        });
+        const output = stdout || stderr || "";
+        if (output.toLowerCase().includes("error") && !output.includes("successfully")) {
+          throw new Error(`Failed to download template: ${output}`);
+        }
+        return {
+          content: [
+            {
+              type: "text",
+              text: formatSuccessMessage(
+                `React template downloaded to ${targetDir}`,
+                {
+                  targetDir,
+                  baseUrl: API_BASE_URL,
+                  nextSteps: [
+                    `cd ${targetDir}`,
+                    `npm install`,
+                    `npm run dev`
+                  ]
+                }
+              )
+            }
+          ]
+        };
+      } catch (error) {
+        const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Error downloading template: ${errMsg}`
+            }
+          ],
+          isError: true
+        };
+      }
+    })
+  );
   server.tool(
     "bulk-upsert",
-    "Bulk insert or update data from CSV or JSON file. Supports upsert operations with a unique key.",
+    "Bulk insert or updallet data from CSV or JSON file. Supports upsert operations with a unique key.",
     {
       apiKey: z14.string().optional().describe("API key for authentication (optional if provided via --api_key)"),
       ...bulkUpsertRequestSchema.shape,
@@ -1313,12 +1501,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: [
@@ -1342,10 +1538,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 {
+          content: [
+            {
+              type: "text",
+              text: formatSuccessMessage(`Schedule '${name}' ${action} successfully`, result)
+            }
+          ]
+        };
+      } catch (error) {
+        const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
+        return {
+          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 {
+          content: [
+            {
+              type: "text",
+              text: formatSuccessMessage(`Schedule ${scheduleId} deleted successfully`, result)
+            }
+          ]
+        };
+      } catch (error) {
+        const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Error deleting schedule: ${errMsg}`
+            }
+          ],
+          isError: true
+        };
+      }
+    })
+  );
   return {
     apiKey: GLOBAL_API_KEY,
     apiBaseUrl: API_BASE_URL,
-    toolCount: 14
+    toolCount: 17
   };
 }
 

package/dist/http-server.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   registerInsforgeTools
-} from "./chunk-74IVXADC.js";
+} from "./chunk-OLIGYXLN.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-74IVXADC.js";
+} from "./chunk-OLIGYXLN.js";
 
 // src/stdio/index.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@insforge/mcp",
-  "version": "1.1.7-dev.2",
+  "version": "1.1.7-dev.20",
   "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": {
@@ -31,10 +32,11 @@
   },
   "files": [
     "dist",
-    "mcp.json"
+    "mcp.json",
+    "server.json"
   ],
   "dependencies": {
-    "@insforge/shared-schemas": "^1.1.6",
+    "@insforge/shared-schemas": "^1.1.7",
     "@modelcontextprotocol/sdk": "^1.15.1",
     "@types/express": "^5.0.3",
     "commander": "^14.0.0",

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"
+      }
+    }
+  ]
+}