mcp-unknowncheatz 0.3.7 → 0.3.8

package/README.md

@@ -132,6 +132,8 @@ Browsing or crawling a subforum records its visible listing in the local index.
 
 ## Development
 
+If a tool returns `connect ECONNREFUSED 127.0.0.1:<port>` while Chrome stays on a blank page, update to a build containing the explicit debugging-port fix. `chrome-launcher 1.2.2` can select an old port from the dedicated profile's accumulated log on restart. The server now allocates a fresh loopback port for each launch. Close any abandoned Chrome window using the dedicated MCP profile before restarting the server; keep your ordinary Chrome windows open. A profile must be used by only one server instance at a time. This startup error occurs before forum navigation and is separate from a Cloudflare verification loop.
+
 ```sh
 bun run typecheck
 bun run test

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-unknowncheatz",
-  "version": "0.3.7",
+  "version": "0.3.8",
   "type": "module",
   "description": "MCP server for searching and reading the UnknownCheats forum",
   "bin": {

package/src/browser-port.ts

@@ -0,0 +1,19 @@
+import { createServer } from "node:net";
+
+// Give chrome-launcher an explicit port. Its dynamic-port discovery can read a
+// stale DevTools entry from the persistent profile's append-only chrome-err.log.
+// Release the reservation before Chrome binds; never expose debugging remotely.
+export function getAvailableDebuggingPort(): Promise<number> {
+  return new Promise((resolve, reject) => {
+    const server = createServer();
+    server.once("error", reject);
+    server.listen(0, "127.0.0.1", () => {
+      const address = server.address();
+      if (!address || typeof address === "string" || address.port === 0) {
+        server.close(() => reject(new Error("Could not allocate Chrome debugging port")));
+        return;
+      }
+      server.close((error) => error ? reject(error) : resolve(address.port));
+    });
+  });
+}

package/src/browser.ts

@@ -4,6 +4,7 @@ import os from "node:os";
 import path from "path";
 import { fileURLToPath } from "url";
 import { isApacheNotFoundPage, normalizeThreadUrl } from "./forum-url.js";
+import { getAvailableDebuggingPort } from "./browser-port.js";
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const COOKIES_PATH = path.join(__dirname, "..", "cookies.json");
@@ -102,6 +103,7 @@ async function launchBrowser(): Promise<BrowserInstance> {
   const executablePath = process.env.UC_CHROME_PATH?.trim();
   const existingProfile = existsSync(PROFILE_DIR);
   mkdirSync(PROFILE_DIR, { recursive: true });
+  const debuggingPort = await getAvailableDebuggingPort();
   const { browser, page } = await connect({
     headless: useHeadless(),
     turnstile: true,
@@ -109,6 +111,7 @@ async function launchBrowser(): Promise<BrowserInstance> {
     customConfig: {
       ...(executablePath ? { chromePath: executablePath } : {}),
       userDataDir: PROFILE_DIR,
+      port: debuggingPort,
     },
     connectOption: { defaultViewport: null },
     disableXvfb: useRealDisplay(),