@shipvo/mcp 0.0.6 → 0.0.7

package/README.md

@@ -8,7 +8,7 @@ Lets AI agents (Claude, Cursor, Claude Code, PiPilot…) **use a Shipvo app with
   "env": { "PN_SIM": "http://localhost:4545", "PN_OWNER_TOKEN": "…optional…" } } } }
 ```
 
-Start the simulator first (`shipvo sim` in the app). The hosted version needs no local setup: `{ "url": "https://<host>/mcp/<key>" }`.
+Start the simulator first (`shipvo sim` in the app). The server asks the simulator which app it serves, so `open_app("<your app id>")` works; set `PN_APPS` (JSON) to override. If the simulator cannot be reached, only the sample app opens. The hosted version needs no local setup: `{ "url": "https://<host>/mcp/<key>" }`.
 
 Tools: `list_apps`, `open_app`, `screen`, `tap`, `type`, `scroll`, `back`, `screenshot`, `set_device`, `push_notification`, `notifications`, `open_notification`, `device_log`, `end_session`, `owner_describe`, `owner_command`.
 

package/dist/server.js

@@ -15,9 +15,25 @@ import { z } from "zod";
 const SIM = (process.env.PN_SIM ?? "http://localhost:4545").replace(/\/$/, "");
 const CONTROL = (process.env.PN_CONTROL ?? "https://api.shipvo.dev").replace(/\/$/, "");
 const OWNER_TOKEN = process.env.PN_OWNER_TOKEN ?? "";
-// Apps this server can open. Hosted: the account's apps. Local: one app served by the simulator.
-const APPS = process.env.PN_APPS ? JSON.parse(process.env.PN_APPS)
-    : { tide: { name: "Tide & Tackle", description: "Fishing-supplies shop in Douala: catalogue, cart, promo codes, delivery slots, cash or mobile money." } };
+// Apps this server can open. Hosted: the account's apps. Local: the app the simulator serves (it is asked on
+// first use), or PN_APPS (JSON) to override. Falls back to the sample app when the simulator cannot be reached.
+const TIDE = { tide: { name: "Tide & Tackle", description: "Fishing-supplies shop in Douala: catalogue, cart, promo codes, delivery slots, cash or mobile money." } };
+async function localApps() {
+    if (process.env.PN_APPS)
+        return JSON.parse(process.env.PN_APPS);
+    try {
+        const r = await fetch(SIM + "/apps", { method: "POST", headers: { "content-type": "application/json" }, body: "{}" });
+        if (r.ok) {
+            const out = {};
+            for (const a of (await r.json()).apps ?? [])
+                out[a.id] = { name: a.name ?? a.id, description: "The app this simulator serves." };
+            if (Object.keys(out).length)
+                return out;
+        }
+    }
+    catch { }
+    return TIDE;
+}
 async function sim(path, body) {
     const r = await fetch(SIM + path, { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify(body) });
     if (!r.ok)
@@ -27,7 +43,7 @@ async function sim(path, body) {
 const sessions = new Map();
 const text = (t) => ({ content: [{ type: "text", text: t }] });
 const result = (sid, r) => { const s = sessions.get(sid); if (s)
-    s.steps++; return text(r.ok ? (r.screen ?? "") : `Error: ${r.error}${/no session/.test(String(r.error)) ? " (sessions expire with the phone; call open_app again)" : ""}\n\nScreen now:\n${r.screen ?? ""}`); };
+    s.steps++; return text(r.ok ? (r.screen ?? "") : `Error${r.code ? ` [${r.code}]` : ""}: ${r.error}${/no session/.test(String(r.error)) ? " (sessions expire with the phone; call open_app again)" : ""}\n\nScreen now:\n${r.screen ?? ""}`); };
 // Sessions live in the simulator; this map only tracks step counts. A client may reconnect between calls
 // (ChatGPT does), so an unknown id is forwarded and the simulator answers if it knows it.
 const need = (_sid) => { };
@@ -39,8 +55,9 @@ System sheets (permission dialogs, the camera, the fingerprint prompt, payment p
 Finish a task by checking the final screen says what you expected (for example "Order placed"). Call end_session when done to get a report.` });
     // ctx.app: the app(s) this key opens, comma-separated (the beta app plus any the key owner has registered).
     const keyApps = ctx.app ? ctx.app.split(",").map((s) => s.trim()).filter(Boolean) : null;
-    const allowed = (id) => (keyApps ? keyApps.includes(id) : !!APPS[id]);
+    const allowed = async (id) => (keyApps ? keyApps.includes(id) : !!(await localApps())[id]);
     server.tool("list_apps", "Apps this server can open, with what each one does. Optional query filters by name, description or category (e.g. 'shop', 'douala').", { query: z.string().optional() }, async ({ query }) => {
+        const APPS = await localApps();
         const ids = keyApps ?? Object.keys(APPS);
         const q = (query ?? "").toLowerCase();
         let dir = {};
@@ -65,8 +82,8 @@ Finish a task by checking the final screen says what you expected (for example "
         dark: z.boolean().optional().describe("Dark mode"),
     }, async ({ app, session, seed_cart, dark }) => {
         const id = app.split("@")[0];
-        if (!allowed(id))
-            throw new Error(keyApps ? `this key opens: ${keyApps.join(", ")}` : `unknown app "${id}". Apps: ${Object.keys(APPS).join(", ")}`);
+        if (!(await allowed(id)))
+            throw new Error(keyApps ? `this key opens: ${keyApps.join(", ")}` : `unknown app "${id}". Apps: ${Object.keys(await localApps()).join(", ")}`);
         if (ctx.scope === "read")
             throw new Error("this key is read-only: it cannot open sessions");
         const sid = session ?? `${id}-${Date.now().toString(36)}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shipvo/mcp",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "type": "module",
   "license": "Apache-2.0",
   "description": "MCP server that lets AI agents open, see and operate Shipvo apps without a phone: a phone-sized simulator of the real app, plus the app's typed commands and owner API.",
@@ -14,7 +14,8 @@
   },
   "devDependencies": {
     "typescript": "^5.6.3",
-    "@types/node": "^22.8.0"
+    "@types/node": "^22.8.0",
+    "vitest": "^2.1.4"
   },
   "keywords": [
     "mcp",
@@ -45,6 +46,7 @@
   },
   "mcpName": "io.github.shipvo/shipvo",
   "scripts": {
-    "build": "tsc -p tsconfig.json"
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run"
   }
 }