shipscreens 0.1.2 → 0.1.4

package/README.md

@@ -7,6 +7,14 @@ Build store screenshots as a build step.
 npx --yes shipscreens@latest demo
 ```
 
+## Rendered mode (optional)
+Rendered mode runs the UI renderer headlessly via Playwright Chromium.
+Install Chromium once per machine/CI runner:
+
+```bash
+npx playwright install --with-deps chromium
+```
+
 ## CI pipeline (copy/paste)
 ```bash
 npx --yes shipscreens@latest validate
@@ -17,3 +25,44 @@ npx --yes shipscreens@latest stage --from out --out out/stage --profile appstore
 ```
 
 Docs: https://shipscreens.com/tools/agent-cli/
+
+## MCP server (stdio)
+```bash
+npx --yes shipscreens@latest mcp serve
+```
+
+## Claude Code local setup (.mcp.json)
+```json
+{
+  "mcpServers": {
+    "shipscreens": {
+      "command": "npx",
+      "args": ["--yes", "shipscreens@latest", "mcp", "serve"]
+    }
+  }
+}
+```
+
+Windows users can force `npx` through `cmd /c`:
+```json
+{
+  "mcpServers": {
+    "shipscreens": {
+      "command": "cmd",
+      "args": ["/c", "npx", "--yes", "shipscreens@latest", "mcp", "serve"]
+    }
+  }
+}
+```
+
+Gemini CLI setup (`~/.gemini/settings.json`):
+```json
+{
+  "mcpServers": {
+    "shipscreens": {
+      "command": "npx",
+      "args": ["--yes", "shipscreens@latest", "mcp", "serve"]
+    }
+  }
+}
+```

package/bin/shipscreens.js

@@ -18,6 +18,7 @@ import { runWizard } from '../cli/commands/wizard.js';
 import { runCopyImport } from '../cli/commands/copyImport.js';
 import { resolveCliAuth } from '../cli/auth.js';
 import { listTemplateIds, resolveTemplateConfig } from '../cli/templateConfig.js';
+import { runMcpServer } from '../cli/mcpServer.js';
 import { loadShipScreensConfig } from '../cli/loadConfig.js';
 import { collectAssetReferences } from '../cli/assetRefs.js';
 import {
@@ -49,6 +50,7 @@ Usage:
   shipscreens plan [-c shipscreens.config.yml] [--out <dir>] [--zip-out <path>] [--profile appstore|playstore|any] [--json]
   shipscreens copy import [-c shipscreens.config.yml] [--csv <path>] [--import-mode merge|replace]
   shipscreens auth <login|finish|status|logout> [--domain <cognito-domain>] [--client-id <id>] [--api-base <url>] [--port <port>] [--manual] [--redirect-url <url>]
+  shipscreens mcp serve
 
 Commands:
   init       Create a starter config + placeholder PNGs + copy.csv
@@ -66,6 +68,7 @@ Commands:
   plan       Print a deterministic build/stage plan (JSON)
   copy       Import locale copy from copy.csv into shipscreens.config.yml
   auth       Manage CLI sign-in (required to remove watermarks in CLI exports)
+  mcp        Start a stdio MCP server that exposes ShipScreens tools
 
 Options:
   -c, --config <path>   Path to shipscreens.config.yml (default: ./shipscreens.config.yml)
@@ -105,6 +108,9 @@ Quickstart (no browser):
   shipscreens wizard
   shipscreens build --mode raw --zip --out out
   shipscreens verify --out out --zip --profile appstore
+
+MCP quickstart:
+  shipscreens mcp serve
 `);
 }
 
@@ -184,7 +190,6 @@ async function loadDemoScreenPngs() {
 
     const buffers = [];
     for (const name of pngNames) {
-      // eslint-disable-next-line no-await-in-loop
       buffers.push(await fs.readFile(path.join(DEMO_SCREENS_DIR, name)));
     }
     return buffers;
@@ -338,6 +343,15 @@ async function main() {
     return;
   }
 
+  if (command === 'mcp') {
+    const subcommand = positionals[1] || 'serve';
+    if (subcommand !== 'serve') {
+      throw new Error(`Unknown mcp command: ${subcommand}`);
+    }
+    await runMcpServer();
+    return;
+  }
+
   if (command === 'wizard') {
     const stylePreset = resolveStylePreset({ styleFlag: values.style, templateFlag: values.template });
     const result = await runWizard({

package/cli/commands/build.js

@@ -224,12 +224,13 @@ export async function runBuild({
 
   let chromium;
   try {
-    ({ chromium } = await import('playwright-chromium'));
+    ({ chromium } = await import('playwright-core'));
   } catch (err) {
     await closeServer();
     throw new Error(
-      `Playwright (Chromium) is required for shipscreens build.\n` +
-        `Install dependencies and try again.\n` +
+      `Playwright is required for rendered builds.\n` +
+        `Install Chromium once (or use --mode raw):\n` +
+        `  npx playwright install --with-deps chromium\n` +
         `${err?.message || String(err)}`
     );
   }
@@ -240,7 +241,21 @@ export async function runBuild({
 
   let browser = null;
   try {
-    browser = await chromium.launch({ headless: true });
+    try {
+      browser = await chromium.launch({ headless: true });
+    } catch (err) {
+      const msg = err?.message || String(err);
+      if (msg.includes("Executable doesn't exist") || msg.includes('playwright install')) {
+        throw new Error(
+          `Playwright Chromium is not installed on this machine.\n` +
+            `Run:\n` +
+            `  npx playwright install --with-deps chromium\n` +
+            `Then rerun shipscreens build.\n` +
+            msg
+        );
+      }
+      throw err;
+    }
     const context = await browser.newContext({
       acceptDownloads: true,
       viewport: { width: 1400, height: 900 },