@offlocal/mcp 0.3.1 → 0.3.3

package/dist/client.js

@@ -1,7 +1,13 @@
+import { MCP_VERSION } from "./version.js";
 const API_URL = process.env.OFFLOCAL_API_URL?.replace(/\/+$/, "") ?? "http://localhost:4000";
 const AGENT_KEY = process.env.OFFLOCAL_AGENT_KEY ?? "";
 function authHeaders() {
-    return AGENT_KEY ? { Authorization: `Bearer ${AGENT_KEY}` } : {};
+    const headers = {
+        "x-offlocal-mcp-version": MCP_VERSION,
+    };
+    if (AGENT_KEY)
+        headers.Authorization = `Bearer ${AGENT_KEY}`;
+    return headers;
 }
 export async function pingApi() {
     if (!AGENT_KEY) {
@@ -14,6 +20,15 @@ export async function pingApi() {
             headers: { "content-type": "application/json", ...authHeaders() },
             body: "{}",
         });
+        if (res.status === 426) {
+            const body = await res.text().catch(() => "");
+            return {
+                ok: false,
+                mustUpdate: true,
+                reason: body.slice(0, 300) ||
+                    "This Offlocal MCP version is no longer supported. Update with: npx -y @offlocal/mcp@latest",
+            };
+        }
         if (!res.ok) {
             const body = await res.text().catch(() => "");
             return {
@@ -22,7 +37,11 @@ export async function pingApi() {
             };
         }
         const data = (await res.json());
-        return { ok: true, user: data.user };
+        return {
+            ok: true,
+            user: data.user,
+            updateAvailable: res.headers.get("x-offlocal-mcp-update"),
+        };
     }
     catch (err) {
         const message = err instanceof Error ? err.message : String(err);

package/dist/detect.js

@@ -116,6 +116,21 @@ export async function detectRequirements(sourceDir) {
     if (has("redis") || has("ioredis")) {
         reqs.push({ capability: "redis", reason: "Redis client detected" });
     }
+    const wantsObjectStorage = has("@aws-sdk/client-s3") ||
+        has("@aws-sdk/lib-storage") ||
+        has("aws-sdk") ||
+        has("@google-cloud/storage") ||
+        has("@azure/storage-blob") ||
+        has("minio") ||
+        has("multer-s3") ||
+        has("cloudinary") ||
+        /\b(s3_bucket|bucket_name|storage_bucket|r2_bucket|spaces_bucket|cloudinary_url)\b/.test(envText);
+    if (wantsObjectStorage) {
+        reqs.push({
+            capability: "object_storage",
+            reason: "object-storage client or bucket config detected",
+        });
+    }
     return reqs;
 }
 const WEB_FRAMEWORKS = new Set([
@@ -124,6 +139,7 @@ const WEB_FRAMEWORKS = new Set([
     "remix",
     "astro",
     "vite",
+    "cra",
     "static",
 ]);
 const API_FRAMEWORKS = new Set(["fastify", "hono", "express", "koa", "nestjs"]);
@@ -214,6 +230,8 @@ export function apiUrlEnvVar(framework) {
             return { key: "NEXT_PUBLIC_API_URL", buildTime: true };
         case "vite":
             return { key: "VITE_API_URL", buildTime: true };
+        case "cra":
+            return { key: "REACT_APP_API_URL", buildTime: true };
         case "nuxt":
             return { key: "NUXT_PUBLIC_API_URL", buildTime: true };
         case "astro":
@@ -279,9 +297,12 @@ async function detectPython(sourceDir, appName) {
     const hasManage = await fileExists(join(sourceDir, "manage.py"));
     let framework = "python";
     let startCommand = "python app.py";
+    const notes = [];
     if (hasManage || manifest.includes("django")) {
         framework = "django";
-        startCommand = "python manage.py runserver 0.0.0.0:$PORT";
+        const wsgi = await findDjangoWsgiModule(sourceDir);
+        startCommand = `python manage.py migrate --noinput && gunicorn ${wsgi}:application --bind 0.0.0.0:$PORT`;
+        notes.push("Django runs under gunicorn (production) and migrates on start. IMPORTANT: a default project's `ALLOWED_HOSTS` is empty and will 400 every request. Make settings.py read it from the environment — e.g. `ALLOWED_HOSTS = os.environ.get('ALLOWED_HOSTS', '').split(',')` — and offlocal will set ALLOWED_HOSTS to the live host automatically. Use a real database (SQLite resets on every cold start), and run `collectstatic` in a build step if you serve static files.");
     }
     else if (manifest.includes("fastapi")) {
         framework = "fastapi";
@@ -302,8 +323,27 @@ async function detectPython(sourceDir, appName) {
         startCommand,
         port: 8000,
         strategy: "template",
+        notes: notes.length ? notes : undefined,
     };
 }
+async function findDjangoWsgiModule(sourceDir) {
+    const manage = await readTextSafe(join(sourceDir, "manage.py"));
+    const m = /DJANGO_SETTINGS_MODULE['"]\s*,\s*['"]([\w.]+)\.settings['"]/.exec(manage);
+    if (m?.[1])
+        return `${m[1]}.wsgi`;
+    try {
+        const entries = await readdir(sourceDir, { withFileTypes: true });
+        for (const e of entries) {
+            if (e.isDirectory() &&
+                (await fileExists(join(sourceDir, e.name, "wsgi.py")))) {
+                return `${e.name}.wsgi`;
+            }
+        }
+    }
+    catch {
+    }
+    return "wsgi";
+}
 function pickNodeFramework(deps) {
     if ("next" in deps)
         return "nextjs";
@@ -315,6 +355,8 @@ function pickNodeFramework(deps) {
         return "astro";
     if ("vite" in deps)
         return "vite";
+    if ("react-scripts" in deps || "@craco/craco" in deps)
+        return "cra";
     if ("fastify" in deps)
         return "fastify";
     if ("hono" in deps)
@@ -331,6 +373,8 @@ function nodePort(framework) {
             return 4321;
         case "vite":
             return 4173;
+        case "cra":
+            return 80;
         default:
             return 3000;
     }

package/dist/index.js

@@ -3,6 +3,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
 import { pingApi } from "./client.js";
+import { MCP_VERSION } from "./version.js";
 import { DeployInputShape, RollbackInputShape, deployHandler, rollbackHandler, } from "./tools/deploy.js";
 import { PlansInputShape, plansHandler } from "./tools/plans.js";
 import { StatusInputShape, statusHandler } from "./tools/status.js";
@@ -27,7 +28,7 @@ const PlansSchema = z.object(PlansInputShape);
 async function main() {
     const server = new McpServer({
         name: "offlocal",
-        version: "0.1.0",
+        version: MCP_VERSION,
     });
     server.tool("offlocal_ping", "Verify the Offlocal connection. Returns the signed-in email if connected, or an error message if not. This tool does NOT deploy anything, upload anything, or provision any resources - it is the right tool to call when the user asks to 'check my Offlocal connection' or similar.", PingInputShape, async (args) => pingHandler(PingSchema.parse(args)));
     server.tool("offlocal_plan", "START HERE when the user asks to deploy/ship/set up a project. Detects the app + the resources it needs (e.g. a Postgres database), applies the user's saved platform preferences, and returns a complete proposed plan (which platform for each piece — Offlocal.ai by default, or Supabase/PlanetScale/DigitalOcean/Railway). Present the plan to the user verbatim and let them confirm with 'go' or switch any line. Then execute the steps the plan lists. Do NOT deploy or provision anything until the user confirms the plan.", PlanInputShape, async (args) => planHandler(PlanSchema.parse(args)));
@@ -50,7 +51,16 @@ async function main() {
     process.on("unhandledRejection", (reason) => {
         console.error("offlocal-mcp unhandled rejection (continuing):", reason);
     });
-    pingApi().catch(() => { });
+    pingApi()
+        .then((r) => {
+        if (!r.ok && r.mustUpdate) {
+            console.error(`offlocal-mcp: ${r.reason}`);
+        }
+        else if (r.ok && r.updateAvailable) {
+            console.error(`offlocal-mcp: a newer version (v${r.updateAvailable}) is available — update with: npx -y @offlocal/mcp@latest`);
+        }
+    })
+        .catch(() => { });
     const transport = new StdioServerTransport();
     await server.connect(transport);
 }

package/dist/tools/deploy.js

@@ -75,6 +75,10 @@ export async function deployHandler(input) {
                     (bundle.warnings.length
                         ? bundle.warnings.map((w) => `${ICON.warn} ${w}`).join("\n") + "\n\n"
                         : "") +
+                    (detected.notes?.length
+                        ? detected.notes.map((n) => `${ICON.warn} ${n}`).join("\n\n") +
+                            "\n\n"
+                        : "") +
                     `———\n` +
                     `${ICON.arrow} **Next (you, the agent):** tell the user it's building (usually 2–8 min) and you'll ` +
                     `report back when it's live. Then:\n` +

package/dist/tools/ping.js

@@ -4,6 +4,19 @@ export const PingInputShape = {};
 export async function pingHandler(_input) {
     const result = await pingApi();
     if (!result.ok) {
+        if (result.mustUpdate) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `⚠️ Your Offlocal MCP is out of date and no longer supported.\n\n` +
+                            `${result.reason}\n\n` +
+                            "Update it with: npx -y @offlocal/mcp@latest (then restart the agent).",
+                    },
+                ],
+                structuredContent: { connected: false, mustUpdate: true, reason: result.reason },
+            };
+        }
         return {
             content: [
                 {
@@ -20,14 +33,21 @@ export async function pingHandler(_input) {
         };
     }
     const email = result.user?.email ?? "(unknown)";
+    const updateNote = result.updateAvailable
+        ? `\n\nℹ️ A newer Offlocal MCP (v${result.updateAvailable}) is available — update with: npx -y @offlocal/mcp@latest`
+        : "";
     return {
         content: [
             {
                 type: "text",
-                text: `Connected to Offlocal as ${email}.`,
+                text: `Connected to Offlocal as ${email}.${updateNote}`,
             },
         ],
-        structuredContent: { connected: true, email },
+        structuredContent: {
+            connected: true,
+            email,
+            updateAvailable: result.updateAvailable ?? null,
+        },
     };
 }
 void z;

package/dist/tools/plan.js

@@ -11,6 +11,7 @@ const CAP_LABEL = {
     postgres: "Postgres database",
     mysql: "MySQL database",
     redis: "Redis",
+    object_storage: "Object storage",
 };
 const ROLE_LABEL = {
     web: "Web app",

package/dist/tools/providers.js

@@ -222,7 +222,7 @@ export async function createManagedDatabaseHandler(input) {
     const res = await createManagedDatabase(input.projectId);
     if (res.error) {
         const planHint = res.error === "plan_not_allowed" || res.error === "limit_reached"
-            ? " A Hobby plan or higher is required, or the database limit was reached — plans can be changed at /billing."
+            ? ` Two options: add a managed Postgres by upgrading at /billing, or connect your own database with \`offlocal_connect_provider\` (capability "postgres").`
             : "";
         return text(`${ICON.fail} Couldn't create the managed database: ${res.message ?? res.error}.${planHint}`, res);
     }

package/dist/tools/status.js

@@ -60,6 +60,10 @@ export async function statusHandler(input) {
             lines.push(dep.errorMessage.slice(0, 2000));
             lines.push("```");
         }
+        if (dep.errorType === "build_failed" || dep.errorType === "build_error") {
+            lines.push("");
+            lines.push(`Call \`offlocal_logs({ deploymentId: "${dep.id}" })\` for the full build output, fix the cause, then re-run \`offlocal_deploy\`.`);
+        }
     }
     else {
         lines.push(`${ICON.busy} **${phase}**`);

package/dist/version.js

@@ -0,0 +1,9 @@
+import { createRequire } from "node:module";
+let version = "0.0.0";
+try {
+    const req = createRequire(import.meta.url);
+    version = req("../package.json").version ?? version;
+}
+catch {
+}
+export const MCP_VERSION = version;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@offlocal/mcp",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "MCP server for Offlocal - lets your AI coding agent deploy apps via offlocal_deploy, offlocal_status, offlocal_logs, offlocal_ping.",
   "keywords": [
     "mcp",