@olonjs/mcp 1.0.104

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.js

@@ -0,0 +1,209 @@
+#!/usr/bin/env node
+
+// src/bridge.ts
+import { chromium } from "playwright";
+var PlaywrightBridge = class {
+  constructor(targetUrl, privateKey) {
+    this.targetUrl = targetUrl;
+    this.privateKey = privateKey;
+  }
+  browser = null;
+  page = null;
+  async connect() {
+    console.error(`[PlaywrightBridge] Launching browser...`);
+    this.browser = await chromium.launch({ headless: true });
+    const context = await this.browser.newContext();
+    this.page = await context.newPage();
+    console.error(`[PlaywrightBridge] Navigating to ${this.targetUrl}...`);
+    await this.page.goto(this.targetUrl, { waitUntil: "domcontentloaded" });
+    if (this.privateKey) {
+      try {
+        const authInputSelector = 'input[type="password"]';
+        const authButtonSelector = 'button:has-text("Authenticate")';
+        const isAuthWall = await this.page.locator(authInputSelector).isVisible({ timeout: 2e3 }).catch(() => false);
+        if (isAuthWall) {
+          console.error(`[PlaywrightBridge] Auth wall detected. Injecting private key...`);
+          await this.page.fill(authInputSelector, this.privateKey);
+          await this.page.click(authButtonSelector);
+        }
+      } catch (err) {
+        console.error(`[PlaywrightBridge] Error during auth bypass:`, err);
+      }
+    }
+    console.error(`[PlaywrightBridge] Waiting for WebMCP to initialize...`);
+    await this.page.waitForFunction(() => {
+      return window.navigator.modelContextProtocol !== void 0;
+    }, void 0, { timeout: 15e3 }).catch(() => {
+      throw new Error("Timeout waiting for navigator.modelContextProtocol. Ensure you are navigating to an OlonJS Studio route (e.g. /admin) and WebMCP is enabled.");
+    });
+    console.error(`[PlaywrightBridge] Connected to WebMCP successfully.`);
+  }
+  async listTools() {
+    if (!this.page) throw new Error("Not connected");
+    return this.page.evaluate(() => {
+      return window.navigator.modelContextProtocol.listTools();
+    });
+  }
+  async readResource(uri) {
+    if (!this.page) throw new Error("Not connected");
+    return this.page.evaluate(async (targetUri) => {
+      return window.navigator.modelContextProtocol.readResource(targetUri);
+    }, uri);
+  }
+  async executeTool(toolName, inputArgsJson) {
+    if (!this.page) throw new Error("Not connected");
+    return this.page.evaluate(async ({ name, args }) => {
+      return window.navigator.modelContextProtocol.executeTool(name, args);
+    }, { name: toolName, args: inputArgsJson });
+  }
+  async disconnect() {
+    if (this.browser) {
+      await this.browser.close();
+      this.browser = null;
+      this.page = null;
+      console.error(`[PlaywrightBridge] Disconnected.`);
+    }
+  }
+};
+
+// src/server.ts
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+  ListResourcesRequestSchema,
+  ReadResourceRequestSchema
+} from "@modelcontextprotocol/sdk/types.js";
+var OlonJsMcpServer = class {
+  constructor(bridge) {
+    this.bridge = bridge;
+    this.server = new Server(
+      {
+        name: "@olonjs/mcp",
+        version: "1.0.0"
+      },
+      {
+        capabilities: {
+          tools: {},
+          resources: {}
+          // Enabling resources so Agent can read olon:// URIs
+        }
+      }
+    );
+    this.setupHandlers();
+    this.server.onerror = (error) => console.error("[MCP Error]", error);
+    process.on("SIGINT", async () => {
+      await this.bridge.disconnect();
+      await this.server.close();
+      process.exit(0);
+    });
+  }
+  server;
+  setupHandlers() {
+    this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+      try {
+        const webMcpTools = await this.bridge.listTools();
+        return {
+          tools: webMcpTools.map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: t.inputSchema
+            // MCP SDK expects specific types but general JSON schema is supported
+          }))
+        };
+      } catch (err) {
+        console.error("Failed to list tools:", err);
+        return { tools: [] };
+      }
+    });
+    this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+      try {
+        const { name, arguments: args } = request.params;
+        const resultString = await this.bridge.executeTool(name, JSON.stringify(args || {}));
+        const parsed = JSON.parse(resultString);
+        return {
+          content: parsed.content || [{ type: "text", text: resultString }],
+          isError: parsed.isError || false
+        };
+      } catch (err) {
+        return {
+          content: [{ type: "text", text: `Error calling tool: ${err.message}` }],
+          isError: true
+        };
+      }
+    });
+    this.server.setRequestHandler(ListResourcesRequestSchema, async () => {
+      return {
+        resources: [
+          {
+            uri: "olon://pages/home",
+            name: "Home Page Data",
+            description: "JSON data of the Home page. To fetch other pages, append the slug, e.g. olon://pages/about",
+            mimeType: "application/json"
+          }
+        ]
+      };
+    });
+    this.server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+      try {
+        const uri = request.params.uri;
+        if (!uri.startsWith("olon://")) {
+          throw new Error(`Unsupported URI schema: ${uri}. Only olon:// is supported.`);
+        }
+        const dataString = await this.bridge.readResource(uri);
+        return {
+          contents: [
+            {
+              uri,
+              mimeType: "application/json",
+              text: dataString
+            }
+          ]
+        };
+      } catch (err) {
+        console.error("Failed to read resource:", err);
+        throw err;
+      }
+    });
+  }
+  async run() {
+    console.error("[OlonJsMcpServer] Connecting to WebMCP via Playwright...");
+    await this.bridge.connect();
+    console.error("[OlonJsMcpServer] WebMCP connected. Starting STDIO transport...");
+    const transport = new StdioServerTransport();
+    await this.server.connect(transport);
+    console.error("[OlonJsMcpServer] MCP Server is running and listening on STDIO.");
+  }
+};
+
+// src/cli.ts
+import * as process2 from "process";
+async function main() {
+  const targetUrl = process2.argv[2];
+  if (!targetUrl) {
+    console.error("====================================================");
+    console.error("\u274C Missing Target URL");
+    console.error("Usage: npx @olonjs/mcp <target-url>");
+    console.error("Example: npx @olonjs/mcp http://localhost:5173");
+    console.error("====================================================");
+    process2.exit(1);
+  }
+  const adminUrl = targetUrl.endsWith("/admin") ? targetUrl : `${targetUrl.replace(/\/$/, "")}/admin`;
+  const privateKey = process2.env.OLONJS_PRIVATE_KEY;
+  if (privateKey) {
+    console.error(`[OlonJs MCP] Starting bridge to ${adminUrl} with Auth Injection enabled.`);
+  } else {
+    console.error(`[OlonJs MCP] Starting bridge to ${adminUrl} without Auth Injection. Ensure /admin does not have an Auth Wall or WebMCP is unprotected.`);
+  }
+  try {
+    const bridge = new PlaywrightBridge(adminUrl, privateKey);
+    const server = new OlonJsMcpServer(bridge);
+    await server.run();
+  } catch (error) {
+    console.error("[OlonJs MCP] Fatal error starting server:", error);
+    process2.exit(1);
+  }
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bridge.ts","../src/server.ts","../src/cli.ts"],"sourcesContent":["import { chromium, Browser, Page } from 'playwright';\n\nexport interface WebMcpToolInfo {\n  name: string;\n  description: string;\n  inputSchema: Record<string, unknown>;\n}\n\nexport class PlaywrightBridge {\n  private browser: Browser | null = null;\n  public page: Page | null = null;\n\n  constructor(\n    private targetUrl: string,\n    private privateKey?: string\n  ) {}\n\n  async connect() {\n    console.error(`[PlaywrightBridge] Launching browser...`);\n    this.browser = await chromium.launch({ headless: true });\n    \n    const context = await this.browser.newContext();\n    this.page = await context.newPage();\n\n    console.error(`[PlaywrightBridge] Navigating to ${this.targetUrl}...`);\n    await this.page.goto(this.targetUrl, { waitUntil: 'domcontentloaded' });\n\n    // Try to handle Crypto Auth Wall if it exists\n    if (this.privateKey) {\n      try {\n        // We wait a bit to see if an auth input appears.\n        // In the future, this selector should match the OlonJS AdminGuard.\n        const authInputSelector = 'input[type=\"password\"]'; \n        const authButtonSelector = 'button:has-text(\"Authenticate\")';\n\n        const isAuthWall = await this.page.locator(authInputSelector).isVisible({ timeout: 2000 }).catch(() => false);\n        \n        if (isAuthWall) {\n          console.error(`[PlaywrightBridge] Auth wall detected. Injecting private key...`);\n          await this.page.fill(authInputSelector, this.privateKey);\n          await this.page.click(authButtonSelector);\n        }\n      } catch (err) {\n        console.error(`[PlaywrightBridge] Error during auth bypass:`, err);\n      }\n    }\n\n    console.error(`[PlaywrightBridge] Waiting for WebMCP to initialize...`);\n    \n    // Wait for the navigator.modelContextProtocol to become available\n    await this.page.waitForFunction(() => {\n      return (window.navigator as any).modelContextProtocol !== undefined;\n    }, undefined, { timeout: 15000 }).catch(() => {\n      throw new Error(\"Timeout waiting for navigator.modelContextProtocol. Ensure you are navigating to an OlonJS Studio route (e.g. /admin) and WebMCP is enabled.\");\n    });\n\n    console.error(`[PlaywrightBridge] Connected to WebMCP successfully.`);\n  }\n\n  async listTools(): Promise<WebMcpToolInfo[]> {\n    if (!this.page) throw new Error(\"Not connected\");\n    return this.page.evaluate(() => {\n      return (window.navigator as any).modelContextProtocol.listTools();\n    });\n  }\n\n  async readResource(uri: string): Promise<string> {\n    if (!this.page) throw new Error(\"Not connected\");\n    return this.page.evaluate(async (targetUri) => {\n      return (window.navigator as any).modelContextProtocol.readResource(targetUri);\n    }, uri);\n  }\n\n  async executeTool(toolName: string, inputArgsJson: string): Promise<string> {\n    if (!this.page) throw new Error(\"Not connected\");\n    return this.page.evaluate(async ({ name, args }) => {\n      return (window.navigator as any).modelContextProtocol.executeTool(name, args);\n    }, { name: toolName, args: inputArgsJson });\n  }\n\n  async disconnect() {\n    if (this.browser) {\n      await this.browser.close();\n      this.browser = null;\n      this.page = null;\n      console.error(`[PlaywrightBridge] Disconnected.`);\n    }\n  }\n}\n","import { Server } from \"@modelcontextprotocol/sdk/server/index.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport {\n  CallToolRequestSchema,\n  ListToolsRequestSchema,\n  ListResourcesRequestSchema,\n  ReadResourceRequestSchema\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport type { PlaywrightBridge } from \"./bridge.js\";\n\nexport class OlonJsMcpServer {\n  private server: Server;\n\n  constructor(private bridge: PlaywrightBridge) {\n    this.server = new Server(\n      {\n        name: \"@olonjs/mcp\",\n        version: \"1.0.0\",\n      },\n      {\n        capabilities: {\n          tools: {},\n          resources: {}, // Enabling resources so Agent can read olon:// URIs\n        },\n      }\n    );\n\n    this.setupHandlers();\n    \n    // Error handling\n    this.server.onerror = (error) => console.error(\"[MCP Error]\", error);\n    process.on(\"SIGINT\", async () => {\n      await this.bridge.disconnect();\n      await this.server.close();\n      process.exit(0);\n    });\n  }\n\n  private setupHandlers() {\n    this.server.setRequestHandler(ListToolsRequestSchema, async () => {\n      try {\n        const webMcpTools = await this.bridge.listTools();\n        return {\n          tools: webMcpTools.map((t) => ({\n            name: t.name,\n            description: t.description,\n            inputSchema: t.inputSchema as any, // MCP SDK expects specific types but general JSON schema is supported\n          })),\n        };\n      } catch (err: any) {\n        console.error(\"Failed to list tools:\", err);\n        return { tools: [] };\n      }\n    });\n\n    this.server.setRequestHandler(CallToolRequestSchema, async (request) => {\n      try {\n        const { name, arguments: args } = request.params;\n        const resultString = await this.bridge.executeTool(name, JSON.stringify(args || {}));\n        const parsed = JSON.parse(resultString);\n        \n        return {\n          content: parsed.content || [{ type: \"text\", text: resultString }],\n          isError: parsed.isError || false,\n        };\n      } catch (err: any) {\n        return {\n          content: [{ type: \"text\", text: `Error calling tool: ${err.message}` }],\n          isError: true,\n        };\n      }\n    });\n\n    this.server.setRequestHandler(ListResourcesRequestSchema, async () => {\n      return {\n        resources: [\n          {\n            uri: \"olon://pages/home\",\n            name: \"Home Page Data\",\n            description: \"JSON data of the Home page. To fetch other pages, append the slug, e.g. olon://pages/about\",\n            mimeType: \"application/json\",\n          }\n        ]\n      }\n    });\n\n    this.server.setRequestHandler(ReadResourceRequestSchema, async (request) => {\n      try {\n        const uri = request.params.uri;\n        if (!uri.startsWith(\"olon://\")) {\n          throw new Error(`Unsupported URI schema: ${uri}. Only olon:// is supported.`);\n        }\n\n        const dataString = await this.bridge.readResource(uri);\n        return {\n          contents: [\n            {\n              uri,\n              mimeType: \"application/json\",\n              text: dataString,\n            },\n          ],\n        };\n      } catch (err: any) {\n        console.error(\"Failed to read resource:\", err);\n        throw err;\n      }\n    });\n  }\n\n  async run() {\n    console.error(\"[OlonJsMcpServer] Connecting to WebMCP via Playwright...\");\n    await this.bridge.connect();\n    \n    console.error(\"[OlonJsMcpServer] WebMCP connected. Starting STDIO transport...\");\n    const transport = new StdioServerTransport();\n    await this.server.connect(transport);\n    console.error(\"[OlonJsMcpServer] MCP Server is running and listening on STDIO.\");\n  }\n}\n","#!/usr/bin/env node\r\nimport { PlaywrightBridge } from './bridge.js';\r\nimport { OlonJsMcpServer } from './server.js';\r\nimport * as process from 'node:process';\r\n\r\nasync function main() {\r\n  const targetUrl = process.argv[2];\r\n  if (!targetUrl) {\r\n    console.error('====================================================');\r\n    console.error('❌ Missing Target URL');\r\n    console.error('Usage: npx @olonjs/mcp <target-url>');\r\n    console.error('Example: npx @olonjs/mcp http://localhost:5173');\r\n    console.error('====================================================');\r\n    process.exit(1);\r\n  }\r\n\r\n  // Normalize URL to always point to /admin to access WebMCP\r\n  const adminUrl = targetUrl.endsWith('/admin') ? targetUrl : `${targetUrl.replace(/\\/$/, '')}/admin`;\r\n\r\n  const privateKey = process.env.OLONJS_PRIVATE_KEY;\r\n\r\n  if (privateKey) {\r\n    console.error(`[OlonJs MCP] Starting bridge to ${adminUrl} with Auth Injection enabled.`);\r\n  } else {\r\n    console.error(`[OlonJs MCP] Starting bridge to ${adminUrl} without Auth Injection. Ensure /admin does not have an Auth Wall or WebMCP is unprotected.`);\r\n  }\r\n\r\n  try {\r\n    const bridge = new PlaywrightBridge(adminUrl, privateKey);\r\n    const server = new OlonJsMcpServer(bridge);\r\n    \r\n    await server.run();\r\n  } catch (error) {\r\n    console.error('[OlonJs MCP] Fatal error starting server:', error);\r\n    process.exit(1);\r\n  }\r\n}\r\n\r\nmain();\r\n"],"mappings":"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","names":["process"]}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@olonjs/mcp",
+  "version": "1.0.104",
+  "description": "Local MCP server bridge for OlonJS Tenant Zero-UI automation via Playwright",
+  "private": false,
+  "type": "module",
+  "main": "dist/cli.js",
+  "bin": {
+    "olonjs-mcp": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsup src/cli.ts --format esm --clean",
+    "dev": "tsup src/cli.ts --format esm --watch",
+    "start": "node dist/cli.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.1",
+    "playwright": "^1.49.1",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.6",
+    "typescript": "^5.7.3",
+    "@types/node": "^22.10.2"
+  }
+}

package/src/bridge.ts

@@ -0,0 +1,89 @@
+import { chromium, Browser, Page } from 'playwright';
+
+export interface WebMcpToolInfo {
+  name: string;
+  description: string;
+  inputSchema: Record<string, unknown>;
+}
+
+export class PlaywrightBridge {
+  private browser: Browser | null = null;
+  public page: Page | null = null;
+
+  constructor(
+    private targetUrl: string,
+    private privateKey?: string
+  ) {}
+
+  async connect() {
+    console.error(`[PlaywrightBridge] Launching browser...`);
+    this.browser = await chromium.launch({ headless: true });
+    
+    const context = await this.browser.newContext();
+    this.page = await context.newPage();
+
+    console.error(`[PlaywrightBridge] Navigating to ${this.targetUrl}...`);
+    await this.page.goto(this.targetUrl, { waitUntil: 'domcontentloaded' });
+
+    // Try to handle Crypto Auth Wall if it exists
+    if (this.privateKey) {
+      try {
+        // We wait a bit to see if an auth input appears.
+        // In the future, this selector should match the OlonJS AdminGuard.
+        const authInputSelector = 'input[type="password"]'; 
+        const authButtonSelector = 'button:has-text("Authenticate")';
+
+        const isAuthWall = await this.page.locator(authInputSelector).isVisible({ timeout: 2000 }).catch(() => false);
+        
+        if (isAuthWall) {
+          console.error(`[PlaywrightBridge] Auth wall detected. Injecting private key...`);
+          await this.page.fill(authInputSelector, this.privateKey);
+          await this.page.click(authButtonSelector);
+        }
+      } catch (err) {
+        console.error(`[PlaywrightBridge] Error during auth bypass:`, err);
+      }
+    }
+
+    console.error(`[PlaywrightBridge] Waiting for WebMCP to initialize...`);
+    
+    // Wait for the navigator.modelContextProtocol to become available
+    await this.page.waitForFunction(() => {
+      return (window.navigator as any).modelContextProtocol !== undefined;
+    }, undefined, { timeout: 15000 }).catch(() => {
+      throw new Error("Timeout waiting for navigator.modelContextProtocol. Ensure you are navigating to an OlonJS Studio route (e.g. /admin) and WebMCP is enabled.");
+    });
+
+    console.error(`[PlaywrightBridge] Connected to WebMCP successfully.`);
+  }
+
+  async listTools(): Promise<WebMcpToolInfo[]> {
+    if (!this.page) throw new Error("Not connected");
+    return this.page.evaluate(() => {
+      return (window.navigator as any).modelContextProtocol.listTools();
+    });
+  }
+
+  async readResource(uri: string): Promise<string> {
+    if (!this.page) throw new Error("Not connected");
+    return this.page.evaluate(async (targetUri) => {
+      return (window.navigator as any).modelContextProtocol.readResource(targetUri);
+    }, uri);
+  }
+
+  async executeTool(toolName: string, inputArgsJson: string): Promise<string> {
+    if (!this.page) throw new Error("Not connected");
+    return this.page.evaluate(async ({ name, args }) => {
+      return (window.navigator as any).modelContextProtocol.executeTool(name, args);
+    }, { name: toolName, args: inputArgsJson });
+  }
+
+  async disconnect() {
+    if (this.browser) {
+      await this.browser.close();
+      this.browser = null;
+      this.page = null;
+      console.error(`[PlaywrightBridge] Disconnected.`);
+    }
+  }
+}

package/src/cli.ts

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+import { PlaywrightBridge } from './bridge.js';
+import { OlonJsMcpServer } from './server.js';
+import * as process from 'node:process';
+
+async function main() {
+  const targetUrl = process.argv[2];
+  if (!targetUrl) {
+    console.error('====================================================');
+    console.error('❌ Missing Target URL');
+    console.error('Usage: npx @olonjs/mcp <target-url>');
+    console.error('Example: npx @olonjs/mcp http://localhost:5173');
+    console.error('====================================================');
+    process.exit(1);
+  }
+
+  // Normalize URL to always point to /admin to access WebMCP
+  const adminUrl = targetUrl.endsWith('/admin') ? targetUrl : `${targetUrl.replace(/\/$/, '')}/admin`;
+
+  const privateKey = process.env.OLONJS_PRIVATE_KEY;
+
+  if (privateKey) {
+    console.error(`[OlonJs MCP] Starting bridge to ${adminUrl} with Auth Injection enabled.`);
+  } else {
+    console.error(`[OlonJs MCP] Starting bridge to ${adminUrl} without Auth Injection. Ensure /admin does not have an Auth Wall or WebMCP is unprotected.`);
+  }
+
+  try {
+    const bridge = new PlaywrightBridge(adminUrl, privateKey);
+    const server = new OlonJsMcpServer(bridge);
+    
+    await server.run();
+  } catch (error) {
+    console.error('[OlonJs MCP] Fatal error starting server:', error);
+    process.exit(1);
+  }
+}
+
+main();

package/src/server.ts

@@ -0,0 +1,120 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+  ListResourcesRequestSchema,
+  ReadResourceRequestSchema
+} from "@modelcontextprotocol/sdk/types.js";
+import type { PlaywrightBridge } from "./bridge.js";
+
+export class OlonJsMcpServer {
+  private server: Server;
+
+  constructor(private bridge: PlaywrightBridge) {
+    this.server = new Server(
+      {
+        name: "@olonjs/mcp",
+        version: "1.0.0",
+      },
+      {
+        capabilities: {
+          tools: {},
+          resources: {}, // Enabling resources so Agent can read olon:// URIs
+        },
+      }
+    );
+
+    this.setupHandlers();
+    
+    // Error handling
+    this.server.onerror = (error) => console.error("[MCP Error]", error);
+    process.on("SIGINT", async () => {
+      await this.bridge.disconnect();
+      await this.server.close();
+      process.exit(0);
+    });
+  }
+
+  private setupHandlers() {
+    this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+      try {
+        const webMcpTools = await this.bridge.listTools();
+        return {
+          tools: webMcpTools.map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: t.inputSchema as any, // MCP SDK expects specific types but general JSON schema is supported
+          })),
+        };
+      } catch (err: any) {
+        console.error("Failed to list tools:", err);
+        return { tools: [] };
+      }
+    });
+
+    this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+      try {
+        const { name, arguments: args } = request.params;
+        const resultString = await this.bridge.executeTool(name, JSON.stringify(args || {}));
+        const parsed = JSON.parse(resultString);
+        
+        return {
+          content: parsed.content || [{ type: "text", text: resultString }],
+          isError: parsed.isError || false,
+        };
+      } catch (err: any) {
+        return {
+          content: [{ type: "text", text: `Error calling tool: ${err.message}` }],
+          isError: true,
+        };
+      }
+    });
+
+    this.server.setRequestHandler(ListResourcesRequestSchema, async () => {
+      return {
+        resources: [
+          {
+            uri: "olon://pages/home",
+            name: "Home Page Data",
+            description: "JSON data of the Home page. To fetch other pages, append the slug, e.g. olon://pages/about",
+            mimeType: "application/json",
+          }
+        ]
+      }
+    });
+
+    this.server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+      try {
+        const uri = request.params.uri;
+        if (!uri.startsWith("olon://")) {
+          throw new Error(`Unsupported URI schema: ${uri}. Only olon:// is supported.`);
+        }
+
+        const dataString = await this.bridge.readResource(uri);
+        return {
+          contents: [
+            {
+              uri,
+              mimeType: "application/json",
+              text: dataString,
+            },
+          ],
+        };
+      } catch (err: any) {
+        console.error("Failed to read resource:", err);
+        throw err;
+      }
+    });
+  }
+
+  async run() {
+    console.error("[OlonJsMcpServer] Connecting to WebMCP via Playwright...");
+    await this.bridge.connect();
+    
+    console.error("[OlonJsMcpServer] WebMCP connected. Starting STDIO transport...");
+    const transport = new StdioServerTransport();
+    await this.server.connect(transport);
+    console.error("[OlonJsMcpServer] MCP Server is running and listening on STDIO.");
+  }
+}

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022", "DOM"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/tsup.config.ts

@@ -0,0 +1,11 @@
+import { defineConfig } from 'tsup';
+
+export default defineConfig({
+  entry: ['src/cli.ts'],
+  format: ['esm'],
+  target: 'es2022',
+  clean: true,
+  dts: true,
+  sourcemap: true,
+  outExtension: () => ({ js: '.js' }),
+});