@insforge/mcp 1.1.5-dev.1 → 1.1.5

package/dist/{chunk-5GCPJFTK.js → chunk-7CREF7XU.js}

@@ -778,6 +778,28 @@ 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) => {
+    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}`
+      });
+    }
+    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>",
@@ -785,7 +807,7 @@ function registerInsforgeTools(server, config = {}) {
     withUsageTracking("get-instructions", async () => {
       try {
         const content = await fetchDocumentation("instructions");
-        return {
+        const response = {
           content: [
             {
               type: "text",
@@ -793,11 +815,13 @@ function registerInsforgeTools(server, config = {}) {
             }
           ]
         };
+        return await addBackgroundContext(response);
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
-        return {
+        const errorResponse = {
           content: [{ type: "text", text: `Error: ${errMsg}` }]
         };
+        return await addBackgroundContext(errorResponse);
       }
     })
   );
@@ -807,14 +831,14 @@ function registerInsforgeTools(server, config = {}) {
     {},
     async () => {
       try {
-        return {
+        return await addBackgroundContext({
           content: [{ type: "text", text: `API key: ${getApiKey()}` }]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
-        return {
+        return await addBackgroundContext({
           content: [{ type: "text", text: `Error: ${errMsg}` }]
-        };
+        });
       }
     }
   );
@@ -835,17 +859,17 @@ 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 {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
@@ -853,7 +877,7 @@ function registerInsforgeTools(server, config = {}) {
             }
           ],
           isError: true
-        };
+        });
       }
     })
   );
@@ -873,7 +897,7 @@ function registerInsforgeTools(server, config = {}) {
           }
         });
         const metadata = await handleApiResponse(response);
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
@@ -882,10 +906,10 @@ function registerInsforgeTools(server, config = {}) {
 ${JSON.stringify(metadata, null, 2)}`
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
@@ -893,7 +917,7 @@ ${JSON.stringify(metadata, null, 2)}`
             }
           ],
           isError: true
-        };
+        });
       }
     })
   );
@@ -920,17 +944,17 @@ ${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 {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
@@ -938,7 +962,7 @@ ${JSON.stringify(metadata, null, 2)}`
             }
           ],
           isError: true
-        };
+        });
       }
     })
   );
@@ -971,7 +995,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",
@@ -984,10 +1008,10 @@ ${JSON.stringify(metadata, null, 2)}`
               })
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
@@ -995,7 +1019,7 @@ ${JSON.stringify(metadata, null, 2)}`
             }
           ],
           isError: true
-        };
+        });
       }
     })
   );
@@ -1018,17 +1042,17 @@ ${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 {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
@@ -1036,7 +1060,7 @@ ${JSON.stringify(metadata, null, 2)}`
             }
           ],
           isError: true
-        };
+        });
       }
     })
   );
@@ -1053,17 +1077,17 @@ ${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 {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
@@ -1071,7 +1095,7 @@ ${JSON.stringify(metadata, null, 2)}`
             }
           ],
           isError: true
-        };
+        });
       }
     })
   );
@@ -1092,17 +1116,17 @@ ${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 {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
@@ -1110,7 +1134,7 @@ ${JSON.stringify(metadata, null, 2)}`
             }
           ],
           isError: true
-        };
+        });
       }
     })
   );
@@ -1148,7 +1172,7 @@ ${JSON.stringify(metadata, null, 2)}`
           })
         });
         const result = await handleApiResponse(response);
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
@@ -1158,10 +1182,10 @@ ${JSON.stringify(metadata, null, 2)}`
               )
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
@@ -1169,7 +1193,7 @@ ${JSON.stringify(metadata, null, 2)}`
             }
           ],
           isError: true
-        };
+        });
       }
     })
   );
@@ -1188,17 +1212,17 @@ ${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 {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
@@ -1206,7 +1230,7 @@ ${JSON.stringify(metadata, null, 2)}`
             }
           ],
           isError: true
-        };
+        });
       }
     })
   );
@@ -1251,7 +1275,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",
@@ -1261,10 +1285,10 @@ ${JSON.stringify(metadata, null, 2)}`
               )
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
@@ -1272,7 +1296,7 @@ ${JSON.stringify(metadata, null, 2)}`
             }
           ],
           isError: true
-        };
+        });
       }
     })
   );
@@ -1291,17 +1315,17 @@ ${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 {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
@@ -1309,7 +1333,7 @@ ${JSON.stringify(metadata, null, 2)}`
             }
           ],
           isError: true
-        };
+        });
       }
     })
   );
@@ -1326,24 +1350,32 @@ ${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 {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
@@ -1351,7 +1383,7 @@ ${JSON.stringify(metadata, null, 2)}`
             }
           ],
           isError: true
-        };
+        });
       }
     })
   );

package/dist/http-server.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   registerInsforgeTools
-} from "./chunk-5GCPJFTK.js";
+} from "./chunk-7CREF7XU.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-5GCPJFTK.js";
+} from "./chunk-7CREF7XU.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.5-dev.1",
+  "version": "1.1.5",
   "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.1",

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