@oimdb/mcp 1.2.0 → 3.0.0

package/README.md

@@ -1,59 +1,19 @@
 # @oimdb/mcp
 
-Connects AI assistants to a live OIMDB store running in the browser. Provides MCP tools for Claude Code and an optional CDP inspector for any AI that can run a shell command.
+The MCP server for OIMDB. It gives an AI assistant the tools `oimdb_inspect`, `oimdb_dump`,
+`oimdb_collection` and `oimdb_computed` over a live browser tab or an in-process model. It is built on
+`@oimdb/cli`, which answers the same four questions from a shell: an assistant that can run a command
+can use `npx @oimdb/cli inspect` instead.
 
-📖 **[Full documentation](https://abaikov.github.io/oimdb/)**
+📖 **[Full documentation](https://oimdb.org/)**
 
 ## For AI Assistants
 
-If you are an AI assistant and this package is present in the project, you can get live OIMDB state from the running browser tab.
+**Check whether MCP is already configured.** Look for `mcpServers.oimdb` in `.claude/settings.json` or
+`~/.claude/settings.json`. If it is there, call `oimdb_inspect` now to see the current state.
 
-**Check if MCP is already configured** — look for `mcpServers.oimdb` in `.claude/settings.json` or `~/.claude/settings.json`. If it is, the tools `oimdb_inspect`, `oimdb_dump`, `oimdb_collection`, and `oimdb_computed` are available. Call `oimdb_inspect` now to see the current state.
-
-**If MCP is not configured yet**, add this to the project's MCP config:
-
-- Claude Code: `.claude/settings.json`
-- Cursor: `.cursor/mcp.json`
-
-```json
-{
-  "mcpServers": {
-    "oimdb": {
-      "command": "npx",
-      "args": ["-y", "@oimdb/mcp"]
-    }
-  }
-}
-```
-
-Then ask the user to:
-1. Reload Claude Code so the MCP server starts
-2. Make sure `debug.ts` calls `registry.connect()` and the app is running in the browser
-
-**If the user just wants a one-shot snapshot** without MCP setup, run this via Bash (requires Chrome launched with `--remote-debugging-port=9222`):
-
-```bash
-npx @oimdb/mcp cdp
-```
-
-## Human Setup
-
-### Standalone DevTools UI (for humans)
-
-```bash
-npx @oimdb/mcp devtools
-```
-
-Opens `http://localhost:7433` automatically. Shows live collections and computeds from the running browser tab. No Chrome extension needed.
-
-```bash
-OIMDB_WS_PORT=7433 OIMDB_UI_PORT=7434 npx @oimdb/mcp devtools   # custom ports
-npx @oimdb/mcp devtools --no-open                                 # don't open browser
-```
-
-### 1. Add MCP config (for AI tools)
-
-Claude Code — `.claude/settings.json`:
+**If MCP is not configured yet**, add this to the project's MCP config (Claude Code: `.claude/settings.json`,
+Cursor: `.cursor/mcp.json`):
 
 ```json
 {
@@ -66,111 +26,47 @@ Claude Code — `.claude/settings.json`:
 }
 ```
 
-Cursor — `.cursor/mcp.json`:
-
-```json
-{
-  "mcpServers": {
-    "oimdb": {
-      "command": "npx",
-      "args": ["-y", "@oimdb/mcp"]
-    }
-  }
-}
-```
-
-### 2. Connect the browser
+Then ask the user to reload the assistant so the server starts, and to make sure the page connects to the
+bridge:
 
 ```ts
 // src/debug.ts
 import './store/users.debug';
 import './store/tasks.debug';
-import { registry } from '@oimdb/devtools';
+import { oimDevRegistry } from '@oimdb/devtools';
 
 if (typeof window !== 'undefined') {
-    (window as Record<string, unknown>).__OIMDB_DEV__ = registry;
-    registry.connect(); // connects to ws://localhost:7432
+    (window as unknown as Record<string, unknown>).__OIMDB_DEV__ = oimDevRegistry;
+    oimDevRegistry.connect(); // connects to ws://localhost:7432
 }
 ```
 
-### 3. Use from Claude
-
-```
-Call oimdb_inspect to see what's in the store.
-```
-
 ## Available MCP Tools
 
 | Tool | Description |
 |---|---|
-| `oimdb_inspect` | Full structured state — all collections, computeds, dep graph |
-| `oimdb_dump` | Human-readable text summary (same as `registry.dump()`) |
+| `oimdb_inspect` | Full structured state — collections with their index keys and relations, computeds, flush history, errors |
+| `oimdb_dump` | Human-readable text summary — what `oimDevRegistry.dumpString()` returns |
 | `oimdb_collection` | Details of one collection by name |
-| `oimdb_computed` | Status + deps of one computed by name |
+| `oimdb_computed` | Current value of one registered computed, by name |
 
 ## Offline / static mode (no browser)
 
-By default the tools read a **live browser tab**. You can instead point the
-server at an **in-process model** so it answers offline — ideal for "what's the
-data model?" questions without running the app.
-
-**CLI — a model module.** Set `OIMDB_MODEL_MODULE` to a module that builds the
-model in Node and exports a `registry` (or a default export, or a zero-arg
-factory returning one):
-
-```ts
-// oimdb-model.js  (built JS, or run the server under a TS loader)
-import { OIMEventQueue, OIMReactiveCollection } from '@oimdb/core';
-import { OIMDevRegistry } from '@oimdb/devtools';
-
-const queue = new OIMEventQueue();
-const users = new OIMReactiveCollection(queue, { selectPk: u => u.id });
-
-export const registry = new OIMDevRegistry();
-registry.collection('users', users, { indexes: { /* ... */ } });
-```
-
 ```bash
 OIMDB_MODEL_MODULE=./oimdb-model.js npx @oimdb/mcp
 ```
 
-No WebSocket port is opened in this mode — no browser required.
-
-**Embedded — inject a registry.** When running the server from your own Node
-process, pass the registry directly:
+The module is the one `@oimdb/cli` reads with `--model`; see its README. No WebSocket port is opened in this
+mode. From your own Node process, pass the registry directly:
 
 ```ts
 import { createOIMDevMcpServer } from '@oimdb/mcp';
-import { registry } from './oimdb-model';
-
-await createOIMDevMcpServer({ registry }).start();
-```
-
-> **Fields offline:** structure (collections, indexes, relations) is available
-> as soon as the model is constructed. Entity **field names** appear only when
-> the model holds at least one sample entity (TypeScript types are erased at
-> runtime) — seed a representative row in the model module if you want them.
-
-## CDP Inspector (no browser-side code needed)
-
-Launch Chrome with `--remote-debugging-port=9222`, then:
-
-```bash
-npx @oimdb/mcp cdp
-npx @oimdb/mcp cdp | jq .collections
-OIMDB_CDP_URL=http://localhost:9222 npx @oimdb/mcp cdp
-```
-
-## Port
-
-The MCP bridge WebSocket runs on port `7432` by default. Change it:
+import { oimDevRegistry } from '@oimdb/devtools';
 
-```bash
-OIMDB_WS_PORT=7433 npx @oimdb/mcp
+await createOIMDevMcpServer({ registry: oimDevRegistry }).start();
 ```
 
-Update `registry.connect()` accordingly:
-
-```ts
-registry.connect('ws://localhost:7433');
-```
+`createOIMDevMcpServer(options?)` takes `wsPort?` (7432), `registry?`, `modelModulePath?`, `host?`
+(`127.0.0.1`) and `allowedOrigins?` (`[]`). The bridge, ports, host and origin rules are `@oimdb/cli`'s and are
+described in its README; `OIMDB_WS_PORT`, `OIMDB_HOST`, `OIMDB_ALLOWED_ORIGINS` and `OIMDB_MODEL_MODULE` set them
+here too.

package/bin/oimdb-mcp.cjs

@@ -1,24 +1,23 @@
 #!/usr/bin/env node
-/**
- * Single entry point for @oimdb/mcp. Dispatches on the first argument so all of
- * these work via npx (one bin → npx can always resolve it):
- *
- *   npx @oimdb/mcp            # MCP server (default; for AI tools)
- *   npx @oimdb/mcp devtools   # standalone DevTools UI (for humans)
- *   npx @oimdb/mcp cdp        # one-shot CDP snapshot to stdout
- */
+// The servers catch what they can reach; this is the net for what they cannot.
+// It lives in the CLI and NOT in the library classes, because those also run
+// embedded in somebody else's process, where deciding that the process survives
+// its own uncaught errors is not ours to make. stderr only — MCP mode speaks
+// protocol on stdout.
+process.on('uncaughtException', err => {
+    process.stderr.write(`[OIMDB] Uncaught error (continuing): ${err && err.stack ? err.stack : String(err)}\n`);
+});
+process.on('unhandledRejection', reason => {
+    process.stderr.write(`[OIMDB] Unhandled rejection (continuing): ${String(reason)}\n`);
+});
 const sub = process.argv[2];
 
-if (sub === 'devtools') {
-    require('./devtools.cjs')();
-} else if (sub === 'cdp') {
-    require('./cdp.cjs')();
-} else if (sub === undefined || sub === 'mcp' || sub === 'serve') {
+if (sub === undefined || sub === 'mcp' || sub === 'serve') {
     require('./server.cjs')();
 } else {
     process.stderr.write(
         `[OIMDB] Unknown command: ${sub}\n` +
-            'Usage: oimdb-mcp [devtools|cdp]  (no argument = MCP server)\n'
+            'Usage: oimdb-mcp  (the MCP server). The DevTools UI and the CDP snapshot are in @oimdb/cli: oimdb serve, oimdb inspect --cdp.\n'
     );
     process.exit(1);
 }

package/bin/server.cjs

@@ -7,7 +7,16 @@ module.exports = function runMcpServer() {
         : 7432;
     // Offline/static mode: point at a module that builds the model in-process.
     const modelModulePath = process.env.OIMDB_MODEL_MODULE || undefined;
-    const server = new OIMDevMcpServer({ wsPort, modelModulePath });
+    // Loopback unless told otherwise. This port hands out the application's
+    // whole data model, so binding every interface — which is what happens when
+    // no host is given — puts it on the café Wi-Fi.
+    const host = process.env.OIMDB_HOST || '127.0.0.1';
+    // Exact page origins, comma-separated. Never '*'.
+    const allowedOrigins = (process.env.OIMDB_ALLOWED_ORIGINS || '')
+        .split(',')
+        .map(s => s.trim())
+        .filter(Boolean);
+    const server = new OIMDevMcpServer({ wsPort, modelModulePath, host, allowedOrigins });
     server.start().catch(err => {
         process.stderr.write('[OIMDB MCP] Fatal: ' + err.message + '\n');
         process.exit(1);

package/dist/index.cjs

@@ -21,42 +21,36 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   OIMDevMcpServer: () => OIMDevMcpServer,
-  OIMDevUIServer: () => OIMDevUIServer,
-  createOIMDevMcpServer: () => createOIMDevMcpServer,
-  createOIMDevUIServer: () => createOIMDevUIServer
+  createOIMDevMcpServer: () => createOIMDevMcpServer
 });
 module.exports = __toCommonJS(index_exports);
 
 // src/core/OIMDevMcpServer.ts
 var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
 var import_stdio = require("@modelcontextprotocol/sdk/server/stdio.js");
-var import_ws = require("ws");
-var import_node_url = require("url");
-var import_node_path = require("path");
 var import_zod = require("zod");
-async function loadRegistryFromModule(path) {
-  const url = (0, import_node_url.pathToFileURL)((0, import_node_path.resolve)(path)).href;
-  const mod = await import(url);
-  let candidate = mod.registry ?? mod.default ?? mod;
-  if (typeof candidate === "function") {
-    candidate = await candidate();
-  }
-  if (!candidate || typeof candidate.inspect !== "function" || typeof candidate.dumpString !== "function") {
-    throw new Error(
-      `[OIMDB MCP] Module "${path}" must export a registry exposing inspect() and dumpString() (as a "registry" or default export, or a zero-arg factory returning one).`
-    );
-  }
-  return candidate;
-}
+var import_cli = require("@oimdb/cli");
 var OIMDevMcpServer = class {
   constructor(options = {}) {
-    this.wss = null;
-    this.latestBrowser = null;
-    this.pending = /* @__PURE__ */ new Map();
-    this.modelModuleLoaded = false;
-    this.wsPort = options.wsPort ?? 7432;
-    this.inProcessRegistry = options.registry ?? null;
-    this.modelModulePath = options.modelModulePath;
+    const wsPort = options.wsPort ?? 7432;
+    let devStateSource;
+    if (options.registry !== void 0) {
+      devStateSource = new import_cli.OIMDevRegistryStateSource(options.registry);
+    } else if (options.modelModulePath !== void 0) {
+      this.devModuleStateSource = new import_cli.OIMDevModuleStateSource(options.modelModulePath);
+      devStateSource = this.devModuleStateSource;
+    } else {
+      this.devBridge = new import_cli.OIMDevBridge({
+        wsPort,
+        host: options.host ?? "127.0.0.1",
+        allowedOrigins: new Set(options.allowedOrigins ?? []),
+        logPrefix: "[OIMDB MCP]",
+        portInUseHint: "npx @oimdb/mcp",
+        requestTimeoutMessage: "Browser response timeout (5s). Is the page active?"
+      });
+      devStateSource = new import_cli.OIMDevBridgeStateSource(this.devBridge, wsPort);
+    }
+    this.devStateReader = new import_cli.OIMDevStateReader(devStateSource);
     this.mcpServer = new import_mcp.McpServer(
       { name: "oimdb", version: "1.0.0" },
       {
@@ -65,292 +59,30 @@ var OIMDevMcpServer = class {
     );
     this.registerTools();
   }
-  /**
-   * Resolves the in-process registry, loading the model module on first use.
-   * Returns null when no in-process source is configured (browser-bridge mode).
-   */
-  async getInProcessRegistry() {
-    if (this.inProcessRegistry) return this.inProcessRegistry;
-    if (this.modelModulePath && !this.modelModuleLoaded) {
-      this.modelModuleLoaded = true;
-      this.inProcessRegistry = await loadRegistryFromModule(
-        this.modelModulePath
-      );
-    }
-    return this.inProcessRegistry;
-  }
-  /** Reads the inspect snapshot from the in-process model or the browser. */
-  async readInspect() {
-    const registry = await this.getInProcessRegistry();
-    if (registry) return registry.inspect();
-    return this.queryBrowser("inspect");
-  }
-  /** Reads the human-readable dump from the in-process model or the browser. */
-  async readDump() {
-    const registry = await this.getInProcessRegistry();
-    if (registry) return registry.dumpString();
-    return await this.queryBrowser("dump");
-  }
   registerTools() {
     const server = this.mcpServer;
     const nameSchema = { name: import_zod.z.string().describe("Registered name") };
+    const asText = (text) => ({ content: [{ type: "text", text }] });
     server.registerTool("oimdb_inspect", {
       description: "Get full state of all registered OIMDB collections and computeds. Returns structured JSON with entity counts, field names, index keys, relations, and computed statuses. Source is the connected browser tab, or an in-process model when one is configured (offline/static \u2014 field names appear only if the model holds sample entities)."
-    }, async () => {
-      const data = await this.readInspect();
-      return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
-    });
+    }, async () => asText(await this.devStateReader.readInspectText()));
     server.registerTool("oimdb_dump", {
-      description: "Get a human-readable text summary of OIMDB state. Same output as registry.dump(). Reads the connected browser tab or an in-process model when configured."
-    }, async () => {
-      const text = await this.readDump();
-      return { content: [{ type: "text", text }] };
-    });
+      description: "Get a human-readable text summary of OIMDB state. Same output as oimDevRegistry.dump(). Reads the connected browser tab or an in-process model when configured."
+    }, async () => asText(await this.devStateReader.readDumpText()));
     server.registerTool("oimdb_collection", {
       description: "Get details of a specific registered collection: entity count, field names, index keys, and relations.",
       inputSchema: nameSchema
-    }, async ({ name }) => {
-      const data = await this.readInspect();
-      const info = data.collections[name];
-      if (!info) {
-        const available = Object.keys(data.collections).join(", ") || "(none registered)";
-        return { content: [{ type: "text", text: `Collection '${name}' not found. Registered: ${available}` }] };
-      }
-      return { content: [{ type: "text", text: JSON.stringify(info, null, 2) }] };
-    });
+    }, async ({ name }) => asText(await this.devStateReader.readCollectionText(name)));
     server.registerTool("oimdb_computed", {
       description: "Get status and resolved dependency names of a specific registered computed value. Shows fresh/stale/pending status, current value, and which registered sources it depends on.",
       inputSchema: nameSchema
-    }, async ({ name }) => {
-      const data = await this.readInspect();
-      const info = data.computeds[name];
-      if (!info) {
-        const available = Object.keys(data.computeds).join(", ") || "(none registered)";
-        return { content: [{ type: "text", text: `Computed '${name}' not found. Registered: ${available}` }] };
-      }
-      return { content: [{ type: "text", text: JSON.stringify(info, null, 2) }] };
-    });
-  }
-  async queryBrowser(action) {
-    if (!this.latestBrowser) {
-      throw new Error(
-        `No browser tab connected to the OIMDB MCP bridge.
-
-Live mode \u2014 add to your debug entry point:
-  import { registry } from '@oimdb/devtools';
-  registry.connect(); // connects to ws://localhost:${this.wsPort}
-Then reload the page.
-
-Offline mode \u2014 point the server at a model module instead:
-  OIMDB_MODEL_MODULE=./path/to/model.js npx @oimdb/mcp
-(the module exports a "registry" with inspect()/dumpString()).`
-      );
-    }
-    return new Promise((resolve, reject) => {
-      const id = Math.random().toString(36).slice(2);
-      const timer = setTimeout(() => {
-        this.pending.delete(id);
-        reject(new Error("Browser response timeout (5s). Is the page active?"));
-      }, 5e3);
-      this.pending.set(id, { resolve, reject, timer });
-      this.latestBrowser.ws.send(JSON.stringify({ type: "request", id, action }));
-    });
-  }
-  setupWebSocketServer() {
-    this.wss = new import_ws.WebSocketServer({ port: this.wsPort });
-    this.wss.on("error", (err) => {
-      if (err.code === "EADDRINUSE") {
-        process.stderr.write(
-          `[OIMDB MCP] Port ${this.wsPort} is already in use.
-Set a different port: OIMDB_WS_PORT=7433 npx @oimdb/mcp
-`
-        );
-        process.exit(1);
-      }
-      process.stderr.write(`[OIMDB MCP] WebSocket server error: ${err.message}
-`);
-      process.exit(1);
-    });
-    this.wss.on("connection", (ws) => {
-      ws.on("message", (raw) => {
-        const msg = JSON.parse(raw.toString());
-        if (msg.type === "hello") {
-          this.latestBrowser = { ws, url: msg.url, title: msg.title };
-          process.stderr.write(`[OIMDB MCP] Browser connected: ${msg.title} (${msg.url})
-`);
-          return;
-        }
-        if (msg.type === "response") {
-          const pending = this.pending.get(msg.id);
-          if (!pending) return;
-          this.pending.delete(msg.id);
-          clearTimeout(pending.timer);
-          if (msg.error) {
-            pending.reject(new Error(msg.error));
-          } else {
-            pending.resolve(msg.data);
-          }
-        }
-      });
-      ws.on("close", () => {
-        if (this.latestBrowser?.ws === ws) {
-          this.latestBrowser = null;
-          process.stderr.write("[OIMDB MCP] Browser disconnected\n");
-        }
-      });
-    });
-    process.stderr.write(`[OIMDB MCP] Bridge ready on ws://localhost:${this.wsPort}
-`);
+    }, async ({ name }) => asText(await this.devStateReader.readComputedText(name)));
   }
   async start() {
-    const registry = await this.getInProcessRegistry();
-    if (registry) {
-      process.stderr.write(
-        "[OIMDB MCP] In-process model loaded \u2014 serving offline (no browser bridge).\n"
-      );
-    } else {
-      this.setupWebSocketServer();
-    }
-    const transport = new import_stdio.StdioServerTransport();
-    await this.mcpServer.connect(transport);
-  }
-};
-
-// src/core/OIMDevUIServer.ts
-var import_http = require("http");
-var import_fs = require("fs");
-var import_path = require("path");
-var import_child_process = require("child_process");
-var import_ws2 = require("ws");
-var MIME = {
-  ".html": "text/html; charset=utf-8",
-  ".js": "text/javascript; charset=utf-8",
-  ".css": "text/css; charset=utf-8"
-};
-var OIMDevUIServer = class {
-  constructor(options) {
-    this.wss = null;
-    this.latestBrowser = null;
-    this.pending = /* @__PURE__ */ new Map();
-    this.wsPort = options.wsPort ?? 7432;
-    this.uiPort = options.uiPort ?? 7433;
-    this.uiDir = options.uiDir;
-    this.shouldOpen = options.open ?? true;
-  }
-  async queryBrowser(action) {
-    if (!this.latestBrowser) return null;
-    return new Promise((resolve, reject) => {
-      const id = Math.random().toString(36).slice(2);
-      const timer = setTimeout(() => {
-        this.pending.delete(id);
-        reject(new Error("timeout"));
-      }, 5e3);
-      this.pending.set(id, { resolve, reject, timer });
-      this.latestBrowser.ws.send(JSON.stringify({ type: "request", id, action }));
-    });
-  }
-  setupBridge() {
-    this.wss = new import_ws2.WebSocketServer({ port: this.wsPort });
-    this.wss.on("error", (err) => {
-      if (err.code === "EADDRINUSE") {
-        process.stderr.write(
-          `[OIMDB DevTools] Port ${this.wsPort} is already in use.
-Set a different port: OIMDB_WS_PORT=7433 npx @oimdb/mcp devtools
-`
-        );
-        process.exit(1);
-      }
-      process.stderr.write(`[OIMDB DevTools] Bridge error: ${err.message}
-`);
-      process.exit(1);
-    });
-    this.wss.on("connection", (ws) => {
-      ws.on("message", (raw) => {
-        const msg = JSON.parse(raw.toString());
-        if (msg.type === "hello") {
-          this.latestBrowser = { ws, url: msg.url, title: msg.title };
-          process.stderr.write(`[OIMDB DevTools] Browser connected: ${msg.title} (${msg.url})
-`);
-          return;
-        }
-        if (msg.type === "response") {
-          const req = this.pending.get(msg.id);
-          if (!req) return;
-          this.pending.delete(msg.id);
-          clearTimeout(req.timer);
-          if (msg.error) req.reject(new Error(msg.error));
-          else req.resolve(msg.data);
-        }
-      });
-      ws.on("close", () => {
-        if (this.latestBrowser?.ws === ws) {
-          this.latestBrowser = null;
-          process.stderr.write("[OIMDB DevTools] Browser disconnected\n");
-        }
-      });
-    });
-    process.stderr.write(`[OIMDB DevTools] Bridge on ws://localhost:${this.wsPort}
-`);
-  }
-  setupHTTP() {
-    const server = (0, import_http.createServer)((req, res) => {
-      const url = req.url ?? "/";
-      res.setHeader("Access-Control-Allow-Origin", "*");
-      if (url === "/api/inspect") {
-        this.queryBrowser("inspect").then((data) => {
-          res.writeHead(200, { "Content-Type": "application/json" });
-          res.end(JSON.stringify({
-            connected: !!this.latestBrowser,
-            tab: this.latestBrowser ? { url: this.latestBrowser.url, title: this.latestBrowser.title } : null,
-            data
-          }));
-        }).catch(() => {
-          res.writeHead(200, { "Content-Type": "application/json" });
-          res.end(JSON.stringify({ connected: false, tab: null, data: null }));
-        });
-        return;
-      }
-      const filePath = (0, import_path.join)(this.uiDir, url === "/" ? "index.html" : url);
-      try {
-        const content = (0, import_fs.readFileSync)(filePath);
-        res.writeHead(200, { "Content-Type": MIME[(0, import_path.extname)(filePath)] ?? "text/plain" });
-        res.end(content);
-      } catch {
-        res.writeHead(404);
-        res.end("Not found");
-      }
-    });
-    server.on("error", (err) => {
-      if (err.code === "EADDRINUSE") {
-        process.stderr.write(
-          `[OIMDB DevTools] UI port ${this.uiPort} is already in use.
-Set a different port: OIMDB_UI_PORT=7434 npx @oimdb/mcp devtools
-`
-        );
-        process.exit(1);
-      }
-    });
-    server.listen(this.uiPort, () => {
-      const uiUrl = `http://localhost:${this.uiPort}`;
-      process.stderr.write(`[OIMDB DevTools] UI ready \u2192 ${uiUrl}
-`);
-      if (this.shouldOpen) this.openURL(uiUrl);
-    });
-  }
-  openURL(url) {
-    const cmd = process.platform === "win32" ? `start "" "${url}"` : process.platform === "darwin" ? `open "${url}"` : `xdg-open "${url}"`;
-    (0, import_child_process.exec)(cmd, (err) => {
-      if (err) process.stderr.write(`[OIMDB DevTools] Could not open browser: ${err.message}
-`);
-    });
-  }
-  start() {
-    this.setupBridge();
-    this.setupHTTP();
-    process.stderr.write(
-      `[OIMDB DevTools] Add to debug.ts: registry.connect();
-`
-    );
+    if (this.devModuleStateSource !== void 0) await this.devModuleStateSource.loadDevRegistry();
+    if (this.devBridge !== void 0) this.devBridge.start();
+    else process.stderr.write("[OIMDB MCP] In-process model loaded \u2014 serving offline (no browser bridge).\n");
+    await this.mcpServer.connect(new import_stdio.StdioServerTransport());
   }
 };
 
@@ -358,13 +90,8 @@ Set a different port: OIMDB_UI_PORT=7434 npx @oimdb/mcp devtools
 function createOIMDevMcpServer(options) {
   return new OIMDevMcpServer(options);
 }
-function createOIMDevUIServer(options) {
-  return new OIMDevUIServer(options);
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   OIMDevMcpServer,
-  OIMDevUIServer,
-  createOIMDevMcpServer,
-  createOIMDevUIServer
+  createOIMDevMcpServer
 });