@oimdb/mcp 1.1.0 → 1.2.0

package/bin/cdp.cjs

@@ -1,4 +1,3 @@
-#!/usr/bin/env node
 /**
  * One-shot CDP inspector: connects to Chrome, evaluates __OIMDB_DEV__.inspect(),
  * prints JSON to stdout. Pipe to jq or paste into an AI prompt.
@@ -90,7 +89,10 @@ async function run() {
     });
 }
 
-run().catch((err) => {
-    process.stderr.write('[OIMDB CDP] Error: ' + err.message + '\n');
-    process.exit(1);
-});
+/** Run the one-shot CDP snapshot (`cdp` subcommand). */
+module.exports = function runCdp() {
+    run().catch((err) => {
+        process.stderr.write('[OIMDB CDP] Error: ' + err.message + '\n');
+        process.exit(1);
+    });
+};

package/bin/devtools.cjs

@@ -1,11 +1,17 @@
-#!/usr/bin/env node
 const path = require('path');
 const { OIMDevUIServer } = require('../dist/index.cjs');
 
-const wsPort = process.env.OIMDB_WS_PORT ? Number(process.env.OIMDB_WS_PORT) : 7432;
-const uiPort = process.env.OIMDB_UI_PORT ? Number(process.env.OIMDB_UI_PORT) : 7433;
-const noOpen = process.argv.includes('--no-open');
-const uiDir  = path.join(__dirname, '../ui');
+/** Start the standalone DevTools UI server (`devtools` subcommand). */
+module.exports = function runDevtools() {
+    const wsPort = process.env.OIMDB_WS_PORT
+        ? Number(process.env.OIMDB_WS_PORT)
+        : 7432;
+    const uiPort = process.env.OIMDB_UI_PORT
+        ? Number(process.env.OIMDB_UI_PORT)
+        : 7433;
+    const noOpen = process.argv.includes('--no-open');
+    const uiDir = path.join(__dirname, '../ui');
 
-const server = new OIMDevUIServer({ wsPort, uiPort, uiDir, open: !noOpen });
-server.start();
+    const server = new OIMDevUIServer({ wsPort, uiPort, uiDir, open: !noOpen });
+    server.start();
+};

package/bin/oimdb-mcp.cjs

@@ -0,0 +1,24 @@
+#!/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
+ */
+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') {
+    require('./server.cjs')();
+} else {
+    process.stderr.write(
+        `[OIMDB] Unknown command: ${sub}\n` +
+            'Usage: oimdb-mcp [devtools|cdp]  (no argument = MCP server)\n'
+    );
+    process.exit(1);
+}

package/bin/server.cjs

@@ -1,11 +1,15 @@
-#!/usr/bin/env node
 const { OIMDevMcpServer } = require('../dist/index.cjs');
 
-const wsPort = process.env.OIMDB_WS_PORT ? Number(process.env.OIMDB_WS_PORT) : 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 });
-server.start().catch((err) => {
-    process.stderr.write('[OIMDB MCP] Fatal: ' + err.message + '\n');
-    process.exit(1);
-});
+/** Start the MCP server (default subcommand). */
+module.exports = function runMcpServer() {
+    const wsPort = process.env.OIMDB_WS_PORT
+        ? Number(process.env.OIMDB_WS_PORT)
+        : 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 });
+    server.start().catch(err => {
+        process.stderr.write('[OIMDB MCP] Fatal: ' + err.message + '\n');
+        process.exit(1);
+    });
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oimdb/mcp",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "MCP server and CDP inspector for OIMDB — connects AI assistants to live browser state",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -18,9 +18,7 @@
     }
   },
   "bin": {
-    "oimdb-mcp": "bin/server.cjs",
-    "oimdb-devtools": "bin/devtools.cjs",
-    "oimdb-cdp": "bin/cdp.cjs"
+    "oimdb-mcp": "bin/oimdb-mcp.cjs"
   },
   "files": [
     "dist",