@ada-mcp/mcp-server 0.1.9 → 0.1.11

package/README.md

@@ -8,25 +8,27 @@ ADA MCP server package that supports:
 
 ## 标准安装（Cursor / MCP）
 
-请使用 **`@ada-mcp/launcher@0.1.3`** 拉起本包（见 [launcher README](../ada-mcp-launcher/README.md)）：
+请使用 **`@ada-mcp/launcher@0.1.7`** 拉起本包（见 [launcher README](../ada-mcp-launcher/README.md)）：
 
 ```json
 {
   "mcpServers": {
     "ada-mcp": {
       "command": "pnpm",
-      "args": ["dlx", "@ada-mcp/launcher@0.1.3"]
+      "args": ["dlx", "@ada-mcp/launcher@0.1.7"]
     }
   }
 }
 ```
 
-本包版本：**`@ada-mcp/mcp-server@0.1.7`**（由 launcher 默认拉取）。
+本包版本：**`@ada-mcp/mcp-server@0.1.10`**（由 launcher 默认拉取；依赖锁定 `playwright@1.59.1`）。
 
 直接调试本包（无 launcher 拉包前测速）：
 
 ```bash
-pnpm dlx @ada-mcp/mcp-server@0.1.7
+pnpm dlx @ada-mcp/mcp-server@0.1.10
+# npx 等价：
+npx -y @ada-mcp/mcp-server@0.1.10
 ```
 
 ## 启动时自动安装依赖（默认仅 Playwright）
@@ -52,12 +54,12 @@ pnpm dlx @ada-mcp/mcp-server@0.1.7
 - `ADA_PLAYWRIGHT_INSTALL_TIMEOUT_MS`：浏览器下载超时（默认 15 分钟）
 - `ADA_INSTALL_STRATEGY_TIMEOUT_MS`：npm 装包超时（默认 2 分钟）
 
-## 代理与镜像（`0.1.3+`）
+## 代理与镜像（`0.1.10+` 推荐）
 
 | 阶段 | 自动探测最快镜像 |
 |------|------------------|
 | `pnpm dlx @ada-mcp/launcher` | **是** — 拉包前测速（推荐） |
-| `pnpm dlx @ada-mcp/mcp-server` | tarball 仍走本机源；**同次安装的依赖**由 `preinstall` 测速（0.1.5+） |
+| `pnpm dlx @ada-mcp/mcp-server` | tarball 仍走本机源；**同次安装的依赖**由 `preinstall` 测速（仅写入官方 Playwright CDN，`0.1.9+`） |
 | 启动后 `install-deps` | 是 — 内置国内镜像测速（**无需配置**） |
 
 默认 npm 探测候选（按优先级，延迟相同取靠前）：阿里云 npmmirror → 腾讯云 → 华为云 → npm 官方。
@@ -81,26 +83,28 @@ pnpm dlx @ada-mcp/mcp-server@0.1.7
 在标准 `args` 后追加，例如安装全部依赖：
 
 ```json
-"args": ["dlx", "@ada-mcp/launcher@0.1.3", "--install-deps=all"]
+"args": ["dlx", "@ada-mcp/launcher@0.1.7", "--install-deps=all"]
 ```
 
 ## Cursor MCP 配置
 
-与上文**标准配置**相同：`pnpm` + `dlx @ada-mcp/launcher@0.1.3`。
+**pnpm（推荐）**：`pnpm` + `dlx @ada-mcp/launcher@0.1.7`
 
-Windows 若找不到 `pnpm`，可写完整路径，例如 `C:\\Users\\<你>\\AppData\\Roaming\\npm\\pnpm.cmd`，或改用 npx：
+**npx 等价**（`launcher@0.1.7+`）：`npx` + `-y @ada-mcp/launcher@0.1.7`（内层同样 `npx -y` mcp-server，测速逻辑与 pnpm 一致）
 
 ```json
 {
   "mcpServers": {
     "ada-mcp": {
       "command": "npx",
-      "args": ["-y", "@ada-mcp/mcp-server"]
+      "args": ["-y", "@ada-mcp/launcher@0.1.7"]
     }
   }
 }
 ```
 
+Windows 若找不到 `pnpm`，可将 `command` 改为 `pnpm.cmd` 绝对路径；无 pnpm 时只能直接 `npx -y @ada-mcp/mcp-server@0.1.10`（无 launcher 拉包测速）。
+
 ## Remote mode
 
 Set API key in environment variable first:

package/dist/cli.cjs

@@ -3568,6 +3568,39 @@ function resolveBundledPlaywrightCli() {
   const version = String(JSON.parse(raw).version ?? "");
   return { command: "node", cliArgs: [import_node_path5.default.join(root, "cli.js")], version };
 }
+function resolveChromiumBrowserVersion() {
+  try {
+    const browsersPath = require2.resolve("playwright-core/browsers.json");
+    const raw = (0, import_node_fs.readFileSync)(browsersPath, "utf8");
+    const parsed = JSON.parse(raw);
+    const chromium = parsed.browsers?.find((b) => b.name === "chromium");
+    return String(chromium?.browserVersion ?? "").trim();
+  } catch {
+    return "";
+  }
+}
+function playwrightChromiumZipUrl(host, browserVersion) {
+  const h = normalizeHostUrl(host);
+  const base = h.includes("cdn.npmmirror.com/binaries/playwright") || h.endsWith("/binaries/playwright") ? "https://cdn.npmmirror.com/binaries/playwright" : h.includes("npmmirror.com") && !h.includes("/mirrors/playwright") ? "https://npmmirror.com/mirrors/playwright" : h;
+  return `${base}/builds/cft/${browserVersion}/win64/chrome-win64.zip`;
+}
+async function probePlaywrightBrowserArtifact(host, browserVersion) {
+  const url = playwrightChromiumZipUrl(host, browserVersion);
+  const started = Date.now();
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), 8e3);
+  try {
+    const response = await fetch(url, { method: "HEAD", redirect: "follow", signal: controller.signal });
+    if (response.status === 200) {
+      return Date.now() - started;
+    }
+    return null;
+  } catch {
+    return null;
+  } finally {
+    clearTimeout(timer);
+  }
+}
 function requiredAppiumDrivers(config) {
   return Array.from(new Set(config.appium.requiredDrivers ?? []));
 }
@@ -3677,7 +3710,6 @@ async function resolveCompatibleDriverSpecs(driver) {
   return Array.from(new Set(specs));
 }
 var detectedBestRegistryByKey = /* @__PURE__ */ new Map();
-var detectedBestPlaywrightHost = null;
 var PROGRESS_STEPS = [
   "deps.ensure.start",
   "registry.probe.start",
@@ -3859,40 +3891,43 @@ async function probePlaywrightHostLatency(host) {
   }
   return best;
 }
-async function detectBestPlaywrightHost(config) {
-  if (detectedBestPlaywrightHost) {
-    return detectedBestPlaywrightHost;
-  }
+async function rankPlaywrightHosts(config) {
   const candidates = playwrightHostCandidates(config);
-  progress("playwright.host.probe.start", { candidates });
+  const browserVersion = resolveChromiumBrowserVersion();
+  progress("playwright.host.probe.start", { candidates, browserVersion: browserVersion || void 0 });
   const probeResults = await Promise.all(candidates.map(async (candidate) => {
     progress("playwright.host.probe.try", { candidate });
-    const latency = await probePlaywrightHostLatency(candidate);
-    progress("playwright.host.probe.result", { candidate, latencyMs: latency });
-    return { candidate, latency };
+    const artifactLatency = browserVersion ? await probePlaywrightBrowserArtifact(candidate, browserVersion) : null;
+    const rootLatency = await probePlaywrightHostLatency(candidate);
+    const latency = artifactLatency ?? rootLatency;
+    const artifactOk = artifactLatency !== null;
+    progress("playwright.host.probe.result", {
+      candidate,
+      latencyMs: latency,
+      artifactOk,
+      browserVersion: browserVersion || void 0
+    });
+    return { candidate, latency, artifactOk, priority: playwrightHostPriorityIndex(candidates, candidate) };
   }));
-  let best = candidates[0] ?? PLAYWRIGHT_HOST_FALLBACK;
-  let bestLatency = Number.POSITIVE_INFINITY;
-  let bestPriority = Number.POSITIVE_INFINITY;
-  for (const { candidate, latency } of probeResults) {
-    if (latency === null)
-      continue;
-    const priority = playwrightHostPriorityIndex(candidates, candidate);
-    if (latency < bestLatency || latency === bestLatency && priority < bestPriority) {
-      best = candidate;
-      bestLatency = latency;
-      bestPriority = priority;
+  const reachable = probeResults.filter((x) => x.latency !== null);
+  const withArtifact = reachable.filter((x) => x.artifactOk);
+  const pool = withArtifact.length > 0 ? withArtifact : reachable;
+  pool.sort((a, b) => {
+    if (a.artifactOk !== b.artifactOk) {
+      return a.artifactOk ? -1 : 1;
     }
-  }
-  detectedBestPlaywrightHost = best;
-  log("info", {
-    event: "deps.playwright.host.auto-selected",
-    details: {
-      selected: best,
-      candidates
+    if (a.latency !== b.latency) {
+      return (a.latency ?? 0) - (b.latency ?? 0);
     }
+    return a.priority - b.priority;
   });
-  return best;
+  const ranked = pool.map((x) => x.candidate);
+  for (const candidate of candidates) {
+    if (!ranked.includes(candidate)) {
+      ranked.push(candidate);
+    }
+  }
+  return ranked.length > 0 ? ranked : [...candidates];
 }
 async function runInstallWithPriority(config, packages, onLogLine) {
   const npmProxy = await detectBestRegistry(config, npmProxyRegistry());
@@ -4035,16 +4070,37 @@ async function installPlaywrightBrowser(config, onLogLine, options) {
   if (targets.length > 0) {
     installArgs.push(...targets);
   }
-  const selectedHost = await detectBestPlaywrightHost(config);
-  onLogLine?.(`[playwright] \u4F7F\u7528\u5185\u7F6E playwright@${version} CLI\uFF0C\u955C\u50CF ${selectedHost}\uFF0C\u76EE\u6807: ${targets.length ? targets.join(",") : "all"}${options?.force ? " (--force)" : ""}`);
+  const rankedHosts = await rankPlaywrightHosts(config);
   const timeoutMs = playwrightInstallTimeoutMs();
   onLogLine?.(`[playwright] \u5B89\u88C5\u8D85\u65F6\u4E0A\u9650 ${Math.round(timeoutMs / 1e3)}s\uFF08\u53EF\u7528 ADA_PLAYWRIGHT_INSTALL_TIMEOUT_MS \u8C03\u6574\uFF09`);
-  await runCommand2(command, installArgs, {
-    env: { PLAYWRIGHT_DOWNLOAD_HOST: selectedHost },
-    timeoutMs,
-    onLogLine
-  });
-  progress("playwright.browser.install.done", { selectedHost });
+  let lastError;
+  for (let i = 0; i < rankedHosts.length; i++) {
+    const host = rankedHosts[i];
+    if (i > 0) {
+      onLogLine?.(`[playwright] \u4E0A\u4E00\u955C\u50CF\u5931\u8D25\uFF0C\u6539\u8BD5 ${host}`);
+    }
+    onLogLine?.(`[playwright] \u4F7F\u7528\u5185\u7F6E playwright@${version} CLI\uFF0C\u955C\u50CF ${host}\uFF0C\u76EE\u6807: ${targets.length ? targets.join(",") : "all"}${options?.force ? " (--force)" : ""}`);
+    try {
+      await runCommand2(command, installArgs, {
+        env: { PLAYWRIGHT_DOWNLOAD_HOST: host },
+        timeoutMs,
+        onLogLine
+      });
+      progress("playwright.browser.install.done", { selectedHost: host, attempt: i + 1 });
+      return;
+    } catch (error) {
+      lastError = error;
+      log("warn", {
+        event: "deps.playwright.browser.install.host.fail",
+        details: {
+          host,
+          attempt: i + 1,
+          message: error instanceof Error ? error.message : String(error)
+        }
+      });
+    }
+  }
+  throw lastError instanceof Error ? lastError : new Error(String(lastError ?? "playwright browser install failed"));
 }
 async function checkPlaywrightLaunchable() {
   try {
@@ -8477,7 +8533,7 @@ async function startMcpServer() {
     mcpServers: {
       "ada-mcp": {
         command: "pnpm",
-        args: ["dlx", "@ada-mcp/launcher@0.1.3"]
+        args: ["dlx", "@ada-mcp/launcher@0.1.7"]
       }
     }
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ada-mcp/mcp-server",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "ADA MCP server for web/mobile automation (stdio + remote HTTP)",
   "private": false,
   "type": "commonjs",
@@ -31,7 +31,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.17.5",
+    "@modelcontextprotocol/sdk": "1.17.5",
+    "zod": "3.25.76",
     "express": "^5.2.1",
     "jimp": "^1.6.0",
     "js-yaml": "^4.1.0",

package/scripts/preinstall-probes.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * pnpm dlx 安装本包时：preinstall 测速 registry + Playwright CDN，写入 .npmrc 与 .ada-mcp-playwright-host
+ * pnpm dlx / npx -y 安装本包时：preinstall 测速 registry + Playwright CDN，写入 .npmrc 与 .ada-mcp-playwright-host
  */
 import fs from "node:fs";
 import path from "node:path";