@runsnative/mcp-server 0.1.2 → 0.1.4

package/README.md

@@ -2,11 +2,11 @@
 
 RunsNative MCP server — gives any MCP-capable agent access to RunsNative component docs, foundations, design exercises, and theme inference.
 
-Docs content is read from a local checkout of the [runsnative repo](https://github.com/KUKAMANGA-ENTERPRISES/runsnative) via `RUNSNATIVE_CONTENT_ROOT`. A cloud content API (no clone required, updates propagate without reinstalling) is in rollout; once live, the env var becomes optional and the server falls back to the cloud automatically.
+Docs content comes from the RunsNative cloud content API by default — no clone or configuration required, and content updates propagate without reinstalling. Developers working in the [runsnative repo](https://github.com/KUKAMANGA-ENTERPRISES/runsnative) can set `RUNSNATIVE_CONTENT_ROOT` to serve from a local checkout instead.
 
 ## Quick install
 
-Add one block to your MCP client config, pointing `RUNSNATIVE_CONTENT_ROOT` at the `content/` directory of a runsnative checkout.
+Add one block to your MCP client config. No environment configuration is needed.
 
 ### Claude Desktop
 
@@ -18,10 +18,7 @@ Add one block to your MCP client config, pointing `RUNSNATIVE_CONTENT_ROOT` at t
   "mcpServers": {
     "runsnative": {
       "command": "npx",
-      "args": ["-y", "@runsnative/mcp-server"],
-      "env": {
-        "RUNSNATIVE_CONTENT_ROOT": "/path/to/runsnative/content"
-      }
+      "args": ["-y", "@runsnative/mcp-server"]
     }
   }
 }
@@ -36,15 +33,18 @@ Add `.mcp.json` to your project root:
   "mcpServers": {
     "runsnative": {
       "command": "npx",
-      "args": ["-y", "@runsnative/mcp-server"],
-      "env": {
-        "RUNSNATIVE_CONTENT_ROOT": "/path/to/runsnative/content"
-      }
+      "args": ["-y", "@runsnative/mcp-server"]
     }
   }
 }
 ```
 
+To serve from a local checkout instead of the cloud API, add an `env` block:
+
+```json
+"env": { "RUNSNATIVE_CONTENT_ROOT": "/path/to/runsnative/content" }
+```
+
 ## Authoring skill
 
 Once the MCP server is connected, load the RunsNative authoring skill to give your agent full component-authoring guidance. The skill is served at:

package/dist/index.js

@@ -21,7 +21,7 @@ const provider = await createProvider();
 if (provider instanceof RemoteContentProvider) {
     await provider.initialize();
 }
-const server = new Server({ name: 'runsnative-mcp', version: '0.3.0' }, { capabilities: { tools: {} } });
+const server = new Server({ name: 'runsnative-mcp', version: '0.1.4' }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
         GET_COMPONENT_TOOL,

package/dist/inferrer/image-extractor.js

@@ -1,4 +1,13 @@
-import sharp from 'sharp';
+async function loadSharp() {
+    try {
+        // sharp is CJS: under ESM dynamic import the callable is mod.default.
+        const mod = (await import('sharp'));
+        return mod.default;
+    }
+    catch {
+        return null;
+    }
+}
 const MAX_PIXELS = 10_000;
 const MAX_ITER = 20;
 function toHex(r, g, b) {
@@ -11,6 +20,10 @@ function sqDist(ar, ag, ab, br, bg, bb) {
 }
 export async function extractImageColors(buffer, sourceType, k = 5) {
     const extractedAt = new Date().toISOString();
+    const sharp = await loadSharp();
+    if (sharp === null) {
+        throw new Error('sharp is not installed — image color extraction requires it.');
+    }
     const { data, info } = await sharp(buffer)
         .flatten({ background: '#ffffff' })
         .removeAlpha()

package/dist/inferrer/page-fetcher.js

@@ -1,4 +1,12 @@
-import { chromium } from 'playwright';
+export async function loadChromium() {
+    try {
+        const playwright = await import('playwright');
+        return playwright.chromium;
+    }
+    catch {
+        return null;
+    }
+}
 const VIEWPORT = { width: 1280, height: 800 };
 export async function fetchAndRender(url) {
     let parsed;
@@ -11,6 +19,17 @@ export async function fetchAndRender(url) {
     if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
         return { ok: false, error: { code: 'FETCH_ERROR', message: `Unsupported scheme: ${parsed.protocol}`, url } };
     }
+    const chromium = await loadChromium();
+    if (chromium === null) {
+        return {
+            ok: false,
+            error: {
+                code: 'FETCH_ERROR',
+                message: 'playwright is not installed — infer_brand_theme requires it. Install playwright, or use infer_theme for HTML-only analysis.',
+                url,
+            },
+        };
+    }
     const browser = await chromium.launch({ headless: true });
     try {
         const page = await browser.newPage();

package/dist/inferrer/style-extractor.js

@@ -1,8 +1,12 @@
-import { chromium } from 'playwright';
+import { loadChromium } from './page-fetcher.js';
 const SAMPLE_SELECTORS = 'body,h1,h2,h3,h4,h5,h6,p,a,button,input,select,textarea,' +
     'div,span,header,footer,nav,main,section,article,aside,ul,ol,li';
 const MAX_ELEMENTS = 200;
 export async function extractStyles(snapshot) {
+    const chromium = await loadChromium();
+    if (chromium === null) {
+        throw new Error('playwright is not installed — style extraction requires it.');
+    }
     const browser = await chromium.launch({ headless: true });
     try {
         const page = await browser.newPage();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runsnative/mcp-server",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "type": "module",
   "files": [
     "dist/"