@insforge/mcp 1.2.4-deployment.7 → 1.2.4-deployment.8

package/dist/{chunk-UC5S2WUP.js → chunk-O33PL3H4.js}

@@ -7,7 +7,6 @@ import { promises as fs } from "fs";
 import { exec } from "child_process";
 import { promisify } from "util";
 import { tmpdir } from "os";
-import path from "path";
 import archiver from "archiver";
 
 // src/shared/response-handler.ts
@@ -1181,75 +1180,75 @@ var listDeploymentsResponseSchema = z20.object({
 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"
+  // Schedule tools - require backend v1.1.1+
+  "upsert-schedule": { minVersion: "1.1.1" },
+  "delete-schedule": { minVersion: "1.1.1" },
+  // 'get-schedules': { minVersion: '1.1.1' },
+  // 'get-schedule-logs': { minVersion: '1.1.1' },
+  // Deployment tools - require backend v1.2.0+
+  "create-deployment": { minVersion: "1.2.0" }
+  // Example of a deprecated tool (uncomment when needed):
+  // 'legacy-tool': { minVersion: '1.0.0', maxVersion: '1.5.0' },
 };
-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/, "").split("-")[0];
+  const clean2 = v2.replace(/^v/, "").split("-")[0];
+  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;
   }
-  function compareVersions(v1, v2) {
-    const clean1 = v1.replace(/^v/, "").split("-")[0];
-    const clean2 = v2.replace(/^v/, "").split("-")[0];
-    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;
+  return 0;
+}
+function shouldRegisterTool(toolName, backendVersion) {
+  const requirement = TOOL_VERSION_REQUIREMENTS[toolName];
+  if (!requirement) {
+    return true;
   }
-  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"}`);
+  const { minVersion, maxVersion } = requirement;
+  if (minVersion && compareVersions(backendVersion, minVersion) < 0) {
+    return false;
+  }
+  if (maxVersion && compareVersions(backendVersion, maxVersion) > 0) {
+    return false;
+  }
+  return true;
+}
+async function fetchBackendVersion(apiBaseUrl) {
+  const response = await fetch2(`${apiBaseUrl}/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();
+  return health.version;
+}
+async 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);
+  const backendVersion = await fetchBackendVersion(API_BASE_URL);
+  console.error(`Backend version: ${backendVersion}`);
+  let toolCount = 0;
+  const registerTool = (toolName, ...args) => {
+    if (shouldRegisterTool(toolName, backendVersion)) {
+      server.tool(toolName, ...args);
+      toolCount++;
+      return true;
+    } else {
+      const req = TOOL_VERSION_REQUIREMENTS[toolName];
+      const reason = req?.minVersion && compareVersions(backendVersion, req.minVersion) < 0 ? `requires backend >= ${req.minVersion}` : `deprecated after backend ${req?.maxVersion}`;
+      console.error(`Skipping tool '${toolName}': ${reason} (current: ${backendVersion})`);
+      return false;
+    }
+  };
   async function trackToolUsage(toolName, success = true) {
     if (GLOBAL_API_KEY) {
       await usageTracker.trackUsage(toolName, success);
@@ -1306,28 +1305,23 @@ function registerInsforgeTools(server, config = {}) {
     }
   };
   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: `
+    const isLegacyVersion = compareVersions(backendVersion, "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(
+  registerTool(
     "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.',
     {
@@ -1360,7 +1354,7 @@ ${context}`
       }
     })
   );
-  server.tool(
+  registerTool(
     "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.",
     {
@@ -1399,7 +1393,7 @@ ${context}`
       }
     })
   );
-  server.tool(
+  registerTool(
     "get-table-schema",
     "Returns the detailed schema(including RLS, indexes, constraints, etc.) of a specific table",
     {
@@ -1438,7 +1432,7 @@ ${context}`
       }
     })
   );
-  server.tool(
+  registerTool(
     "get-backend-metadata",
     "Index all backend metadata",
     {
@@ -1478,7 +1472,7 @@ ${JSON.stringify(metadata, null, 2)}`
       }
     })
   );
-  server.tool(
+  registerTool(
     "run-raw-sql",
     "Execute raw SQL query with optional parameters. Admin access required. Use with caution as it can modify data directly.",
     {
@@ -1523,7 +1517,7 @@ ${JSON.stringify(metadata, null, 2)}`
       }
     })
   );
-  server.tool(
+  registerTool(
     "download-template",
     "CRITICAL: MANDATORY FIRST STEP for all new InsForge projects. Download pre-configured starter template to a temporary directory. After download, you MUST copy files to current directory using the provided command.",
     {
@@ -1599,7 +1593,7 @@ To: Your current project directory
       }
     })
   );
-  server.tool(
+  registerTool(
     "bulk-upsert",
     "Bulk insert or update data from CSV or JSON file. Supports upsert operations with a unique key.",
     {
@@ -1656,7 +1650,7 @@ To: Your current project directory
       }
     })
   );
-  server.tool(
+  registerTool(
     "create-bucket",
     "Create new storage bucket",
     {
@@ -1697,7 +1691,7 @@ To: Your current project directory
       }
     })
   );
-  server.tool(
+  registerTool(
     "list-buckets",
     "Lists all storage buckets",
     {},
@@ -1732,7 +1726,7 @@ To: Your current project directory
       }
     })
   );
-  server.tool(
+  registerTool(
     "delete-bucket",
     "Deletes a storage bucket",
     {
@@ -1771,7 +1765,7 @@ To: Your current project directory
       }
     })
   );
-  server.tool(
+  registerTool(
     "create-function",
     "Create a new edge function that runs in Deno runtime. The code must be written to a file first for version control",
     {
@@ -1830,7 +1824,7 @@ To: Your current project directory
       }
     })
   );
-  server.tool(
+  registerTool(
     "get-function",
     "Get details of a specific edge function including its code",
     {
@@ -1867,7 +1861,7 @@ To: Your current project directory
       }
     })
   );
-  server.tool(
+  registerTool(
     "update-function",
     "Update an existing edge function code or metadata",
     {
@@ -1933,7 +1927,7 @@ To: Your current project directory
       }
     })
   );
-  server.tool(
+  registerTool(
     "delete-function",
     "Delete an edge function permanently",
     {
@@ -1970,7 +1964,7 @@ To: Your current project directory
       }
     })
   );
-  server.tool(
+  registerTool(
     "get-container-logs",
     "Get latest logs from a specific container/service. Use this to help debug problems with your app.",
     {
@@ -2020,16 +2014,16 @@ To: Your current project directory
       }
     })
   );
-  server.tool(
+  registerTool(
     "create-deployment",
     "Deploy source code from a directory. This tool zips files, uploads to cloud storage, and triggers deployment with optional environment variables and project settings.",
     {
-      sourceDirectory: z21.string().describe("Path to the source directory containing files to deploy"),
+      sourceDirectory: z21.string().describe('Absolute path to the source directory containing files to deploy (e.g., /Users/name/project or C:\\Users\\name\\project). Do not use relative paths like "."'),
       ...startDeploymentRequestSchema.shape
     },
     withUsageTracking("create-deployment", async ({ sourceDirectory, projectSettings, envVars, meta }) => {
       try {
-        const resolvedSourceDir = path.resolve(sourceDirectory);
+        const resolvedSourceDir = sourceDirectory;
         const createResponse = await fetch2(`${API_BASE_URL}/api/deployments`, {
           method: "POST",
           headers: {
@@ -2045,9 +2039,6 @@ To: Your current project directory
           archive.on("data", (chunk) => chunks.push(chunk));
           archive.on("end", () => resolve(Buffer.concat(chunks)));
           archive.on("error", (err) => reject(err));
-          archive.on("warning", (err) => {
-            console.warn("Archiver warning:", err.message);
-          });
           const excludePatterns = [
             "node_modules",
             ".git",
@@ -2126,7 +2117,8 @@ To: Your current project directory
   return {
     apiKey: GLOBAL_API_KEY,
     apiBaseUrl: API_BASE_URL,
-    toolCount: 16
+    toolCount,
+    backendVersion
   };
 }
 

package/dist/http-server.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   registerInsforgeTools
-} from "./chunk-UC5S2WUP.js";
+} from "./chunk-O33PL3H4.js";
 
 // src/http/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -91,7 +91,7 @@ app.post("/mcp", async (req, res) => {
       name: "insforge-mcp",
       version: "1.0.0"
     });
-    registerInsforgeTools(mcpServer, {
+    await registerInsforgeTools(mcpServer, {
       apiKey,
       apiBaseUrl
     });

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   registerInsforgeTools
-} from "./chunk-UC5S2WUP.js";
+} from "./chunk-O33PL3H4.js";
 
 // src/stdio/index.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -12,15 +12,15 @@ program.option("--api_base_url <value>", "API Base URL");
 program.parse(process.argv);
 var options = program.opts();
 var { api_key, api_base_url } = options;
-var server = new McpServer({
-  name: "insforge-mcp",
-  version: "1.0.0"
-});
-var toolsConfig = registerInsforgeTools(server, {
-  apiKey: api_key,
-  apiBaseUrl: api_base_url || process.env.API_BASE_URL
-});
 async function main() {
+  const server = new McpServer({
+    name: "insforge-mcp",
+    version: "1.0.0"
+  });
+  const toolsConfig = await registerInsforgeTools(server, {
+    apiKey: api_key,
+    apiBaseUrl: api_base_url || process.env.API_BASE_URL
+  });
   const transport = new StdioServerTransport();
   await server.connect(transport);
   console.error("Insforge MCP server started");
@@ -30,6 +30,9 @@ async function main() {
     console.error("API Key: Not configured (will require api_key in tool calls)");
   }
   console.error(`API Base URL: ${toolsConfig.apiBaseUrl}`);
+  if (toolsConfig.backendVersion) {
+    console.error(`Backend Version: ${toolsConfig.backendVersion}`);
+  }
   console.error(`Tools registered: ${toolsConfig.toolCount}`);
 }
 main().catch(console.error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@insforge/mcp",
-  "version": "1.2.4-deployment.7",
+  "version": "1.2.4-deployment.8",
   "description": "MCP (Model Context Protocol) server for Insforge backend-as-a-service",
   "mcpName": "io.github.InsForge/insforge-mcp",
   "type": "module",