feat: Bundle opera-devtools-mcp as a dependency.

Resolve the MCP binary via Node module resolution so users no longer
need to install opera-devtools-mcp separately. Falls back to PATH if
the bundled package isn't resolvable, and still honors OPERA_CLI_MCP_BIN.

Author: mugorski

README.md

@@ -30,26 +30,18 @@ snapshot:
 
 ## Install
 
-Prerequisites: **Node.js >= 20**, **Opera** browser ([Opera Neon](https://www.operaneon.com) recommended for AI features), **[opera-devtools-mcp](https://github.com/operasoftware/opera-devtools-mcp)**.
+Prerequisites: **Node.js >= 20**, **Opera** browser ([Opera Neon](https://www.operaneon.com) recommended for AI features).
 
 ### From source
 
-**1. Build and link `opera-devtools-mcp`:**
-
-```sh
-git clone https://github.com/operasoftware/opera-devtools-mcp
-cd opera-devtools-mcp
-npm install && npm run build && npm link
-```
-
-**2. Build and link `opera-browser-cli`:**
+**Build and link `opera-browser-cli`:**
 
 ```sh
 # in this repo
 npm install && npm run build && npm link
 ```
 
-**3. Run first-time setup:**
+**Run first-time setup:**
 
 ```sh
 opera-browser-cli setup
@@ -244,7 +236,7 @@ session is active or the no-session status/help block when one is not.
 | Variable | Default | Purpose |
 | --- | --- | --- |
 | `OPERA_CLI_PORT` | `9224` | Bridge server port |
-| `OPERA_CLI_MCP_BIN` | `opera-devtools-mcp` | MCP server binary |
+| `OPERA_CLI_MCP_BIN` | _(bundled `opera-devtools-mcp`)_ | Override the MCP server binary |
 | `OPERA_CLI_EXECUTABLE_PATH` | _(system Chrome)_ | Custom browser binary |
 | `OPERA_CLI_BROWSER_URL` | — | Connect to an existing browser instance instead of launching one |
 | `OPERA_CLI_USER_DATA_DIR` | — | Persistent Chrome profile directory (skips isolated mode) |

package-lock.json

@@ -43,7 +43,8 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.1",
     "@toon-format/toon": "^2.1.0",
-    "axi-sdk-js": "^0.1.4"
+    "axi-sdk-js": "^0.1.4",
+    "opera-devtools-mcp": "^0.1.1"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package.json

@@ -23,7 +23,8 @@ import {
   type ServerResponse,
 } from "node:http";
 import { existsSync, mkdirSync, unlinkSync, writeFileSync } from "node:fs";
-import { join, resolve } from "node:path";
+import { createRequire } from "node:module";
+import { dirname, join, resolve } from "node:path";
 import { homedir } from "node:os";
 
 const DEFAULT_PORT = Number.parseInt(
@@ -343,8 +344,31 @@ export function buildTransportArgs(): string[] {
   return args;
 }
 
+function resolveOperaMcpBin(): string {
+  if (process.env.OPERA_CLI_MCP_BIN) return process.env.OPERA_CLI_MCP_BIN;
+  try {
+    const require = createRequire(import.meta.url);
+    const pkgPath = require.resolve("opera-devtools-mcp/package.json");
+    const pkgDir = dirname(pkgPath);
+    const pkg = require("opera-devtools-mcp/package.json") as {
+      bin?: Record<string, string> | string;
+    };
+    const binEntry =
+      typeof pkg.bin === "string"
+        ? pkg.bin
+        : pkg.bin?.["opera-devtools-mcp"];
+    if (binEntry) {
+      const resolved = join(pkgDir, binEntry);
+      if (existsSync(resolved)) return resolved;
+    }
+  } catch {
+    // Not installed as a dependency — fall back to PATH
+  }
+  return "opera-devtools-mcp";
+}
+
 function createTransport(): StdioClientTransport {
-  const bin = process.env.OPERA_CLI_MCP_BIN ?? "opera-devtools-mcp";
+  const bin = resolveOperaMcpBin();
   const args = buildTransportArgs();
   if (bin.endsWith(".js")) {
     return new StdioClientTransport({