@insforge/mcp 1.1.7-dev.3 → 1.1.7-dev.31

package/dist/{chunk-CLLI7UFN.js → chunk-TOH3XKIT.js}

@@ -4,6 +4,9 @@
 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";
+import { tmpdir } from "os";
 
 // src/shared/response-handler.ts
 async function handleApiResponse(response) {
@@ -735,10 +738,77 @@ 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 clean1 = v1.replace(/^v/, "");
+    const clean2 = v2.replace(/^v/, "");
+    const parts1 = clean1.split(".").map(Number);
+    const parts2 = clean2.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);
@@ -770,10 +840,14 @@ function registerInsforgeTools(server, config = {}) {
           "Content-Type": "application/json"
         }
       });
+      if (response.status === 404) {
+        throw new Error("Documentation not found");
+      }
       const result = await handleApiResponse(response);
       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");
@@ -782,25 +856,106 @@ function registerInsforgeTools(server, config = {}) {
       throw new Error(`Unable to retrieve ${docType} documentation: ${errMsg}`);
     }
   };
+  const fetchInsforgeInstructionsContext = async () => {
+    try {
+      return await fetchDocumentation("instructions");
+    } catch (error) {
+      console.error("Failed to fetch insforge-instructions.md:", error);
+      return null;
+    }
+  };
+  const addBackgroundContext = async (response) => {
+    try {
+      const currentVersion = await getBackendVersion();
+      const isLegacyVersion = compareVersions(currentVersion, "1.1.7") < 0;
+      if (isLegacyVersion) {
+        const context = await fetchInsforgeInstructionsContext();
+        if (context && response.content && Array.isArray(response.content)) {
+          response.content.push({
+            type: "text",
+            text: `
+
+---
+\u{1F527} INSFORGE DEVELOPMENT RULES (Auto-loaded):
+${context}`
+          });
+        }
+      }
+    } catch {
+      console.warn("Could not determine backend version, skipping background context");
+    }
+    return response;
+  };
   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"]).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,'
+      )
+    },
+    withUsageTracking("fetch-docs", async ({ docType }) => {
       try {
-        const content = await fetchDocumentation("instructions");
-        return {
+        const content = await fetchDocumentation(docType);
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
               text: content
             }
           ]
+        });
+      } catch (error) {
+        const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
+        if (errMsg.includes("404") || errMsg.toLowerCase().includes("not found")) {
+          return {
+            content: [{
+              type: "text",
+              text: `Documentation for "${docType}" is not available. This is likely because your backend version is too old and doesn't support this documentation endpoint yet. This won't affect the functionality of the tools - they will still work correctly.`
+            }]
+          };
+        }
+        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 await addBackgroundContext({
+          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
         };
       }
     })
@@ -822,14 +977,14 @@ function registerInsforgeTools(server, config = {}) {
           }
         });
         const result = await handleApiResponse(response);
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
               text: formatSuccessMessage("Schema retrieved", result)
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
         return {
@@ -860,7 +1015,7 @@ function registerInsforgeTools(server, config = {}) {
           }
         });
         const metadata = await handleApiResponse(response);
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
@@ -869,7 +1024,7 @@ function registerInsforgeTools(server, config = {}) {
 ${JSON.stringify(metadata, null, 2)}`
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
         return {
@@ -907,14 +1062,14 @@ ${JSON.stringify(metadata, null, 2)}`
           body: JSON.stringify(requestBody)
         });
         const result = await handleApiResponse(response);
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
               text: formatSuccessMessage("SQL query executed", result)
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
         return {
@@ -929,9 +1084,85 @@ ${JSON.stringify(metadata, null, 2)}`
       }
     })
   );
+  server.tool(
+    "download-template",
+    "CRITICAL: MANDATORY FIRST STEP for all new InsForge projects. Download pre-configured starter template (React) to a temporary directory. After download, you MUST copy files to current directory using the provided command.",
+    {
+      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 tempDir = tmpdir();
+        const targetDir = projectName || `insforge-${frame}`;
+        const templatePath = `${tempDir}/${targetDir}`;
+        console.error(`[download-template] Target path: ${templatePath}`);
+        try {
+          const stats = await fs.stat(templatePath);
+          if (stats.isDirectory()) {
+            console.error(`[download-template] Removing existing template at ${templatePath}`);
+            await fs.rm(templatePath, { recursive: true, force: true });
+          }
+        } catch {
+        }
+        const command = `npx create-insforge-app ${targetDir} --frame ${frame} --base-url ${API_BASE_URL} --anon-key ${anonKey} --skip-install`;
+        const { stdout, stderr } = await execAsync(command, {
+          maxBuffer: 10 * 1024 * 1024,
+          // 10MB buffer
+          cwd: tempDir
+        });
+        const output = stdout || stderr || "";
+        if (output.toLowerCase().includes("error") && !output.includes("successfully")) {
+          throw new Error(`Failed to download template: ${output}`);
+        }
+        return await addBackgroundContext({
+          content: [
+            {
+              type: "text",
+              text: `\u2705 React template downloaded successfully
+
+\u{1F4C1} Template Location: ${templatePath}
+
+\u26A0\uFE0F  IMPORTANT: The template is in a temporary directory and NOT in your current working directory.
+
+\u{1F534} CRITICAL NEXT STEP REQUIRED:
+You MUST copy ALL files (INCLUDING HIDDEN FILES like .env, .gitignore, etc.) from the temporary directory to your current project directory.
+
+Copy all files from: ${templatePath}
+To: Your current project directory
+`
+            }
+          ]
+        });
+      } 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,
@@ -958,7 +1189,7 @@ ${JSON.stringify(metadata, null, 2)}`
         });
         const result = await handleApiResponse(response);
         const message = result.success ? `Successfully processed ${result.rowsAffected} of ${result.totalRecords} records into table "${result.table}"` : result.message || "Bulk upsert operation completed";
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
@@ -971,7 +1202,7 @@ ${JSON.stringify(metadata, null, 2)}`
               })
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
         return {
@@ -1005,14 +1236,14 @@ ${JSON.stringify(metadata, null, 2)}`
           body: JSON.stringify({ bucketName, isPublic })
         });
         const result = await handleApiResponse(response);
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
               text: formatSuccessMessage("Bucket created", result)
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
         return {
@@ -1040,14 +1271,14 @@ ${JSON.stringify(metadata, null, 2)}`
           }
         });
         const result = await handleApiResponse(response);
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
               text: formatSuccessMessage("Buckets retrieved", result)
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
         return {
@@ -1079,14 +1310,14 @@ ${JSON.stringify(metadata, null, 2)}`
           }
         });
         const result = await handleApiResponse(response);
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
               text: formatSuccessMessage("Bucket deleted", result)
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
         return {
@@ -1135,7 +1366,7 @@ ${JSON.stringify(metadata, null, 2)}`
           })
         });
         const result = await handleApiResponse(response);
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
@@ -1145,7 +1376,7 @@ ${JSON.stringify(metadata, null, 2)}`
               )
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
         return {
@@ -1175,14 +1406,14 @@ ${JSON.stringify(metadata, null, 2)}`
           }
         });
         const result = await handleApiResponse(response);
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
               text: formatSuccessMessage(`Edge function '${args.slug}' details`, result)
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
         return {
@@ -1238,7 +1469,7 @@ ${JSON.stringify(metadata, null, 2)}`
         });
         const result = await handleApiResponse(response);
         const fileInfo = args.codeFile ? ` from ${args.codeFile}` : "";
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
@@ -1248,7 +1479,7 @@ ${JSON.stringify(metadata, null, 2)}`
               )
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
         return {
@@ -1278,14 +1509,14 @@ ${JSON.stringify(metadata, null, 2)}`
           }
         });
         const result = await handleApiResponse(response);
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
               text: formatSuccessMessage(`Edge function '${args.slug}' deleted successfully`, result)
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
         return {
@@ -1313,21 +1544,29 @@ ${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 {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
               text: formatSuccessMessage(`Latest logs from ${source}`, result)
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
         return {
@@ -1345,7 +1584,7 @@ ${JSON.stringify(metadata, null, 2)}`
   return {
     apiKey: GLOBAL_API_KEY,
     apiBaseUrl: API_BASE_URL,
-    toolCount: 14
+    toolCount: 15
   };
 }
 

package/dist/http-server.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   registerInsforgeTools
-} from "./chunk-CLLI7UFN.js";
+} from "./chunk-TOH3XKIT.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-CLLI7UFN.js";
+} from "./chunk-TOH3XKIT.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.3",
+  "version": "1.1.7-dev.31",
   "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,7 +32,8 @@
   },
   "files": [
     "dist",
-    "mcp.json"
+    "mcp.json",
+    "server.json"
   ],
   "dependencies": {
     "@insforge/shared-schemas": "^1.1.7",

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