@ada-mcp/mcp-server 0.1.5 → 0.1.7

package/README.md

@@ -6,24 +6,27 @@ ADA MCP server package that supports:
 - Remote HTTP mode (`server`) with API key authentication
 - MCP **Streamable HTTP** on `POST|GET|DELETE /mcp` (same port as legacy REST), with optional SSE per MCP spec (`@modelcontextprotocol/sdk` transport)
 
-## Run with pnpm（推荐，尤其 Windows）
+## 标准安装（Cursor / MCP）
 
-**全程自动选最快镜像（推荐）：**
+请使用 **`@ada-mcp/launcher@0.1.2`** 拉起本包（见 [launcher README](../ada-mcp-launcher/README.md)）：
 
-```bash
-pnpm dlx @ada-mcp/launcher
+```json
+{
+  "mcpServers": {
+    "ada-mcp": {
+      "command": "pnpm",
+      "args": ["dlx", "@ada-mcp/launcher@0.1.2"]
+    }
+  }
+}
 ```
 
-或直接（`0.1.5+` 在同次 dlx 安装依赖时 `preinstall` 测速）：
+本包版本：**`@ada-mcp/mcp-server@0.1.6`**（由 launcher 默认拉取）。
 
-```bash
-pnpm dlx @ada-mcp/mcp-server
-```
-
-也可用 npm：
+直接调试本包（无 launcher 拉包前测速）：
 
 ```bash
-npx -y @ada-mcp/mcp-server
+pnpm dlx @ada-mcp/mcp-server@0.1.6
 ```
 
 ## 启动时自动安装依赖（默认仅 Playwright）
@@ -55,9 +58,9 @@ npx -y @ada-mcp/mcp-server
 |------|------------------|
 | `pnpm dlx @ada-mcp/launcher` | **是** — 拉包前测速（推荐） |
 | `pnpm dlx @ada-mcp/mcp-server` | tarball 仍走本机源；**同次安装的依赖**由 `preinstall` 测速（0.1.5+） |
-| 启动后 `install-deps` | 是 — 内置五家国内镜像测速（**无需配置**） |
+| 启动后 `install-deps` | 是 — 内置国内镜像测速（**无需配置**） |
 
-默认 npm 探测候选（按优先级，延迟相同取靠前）：阿里云 npmmirror → 腾讯云 → 清华 → 华为云 → 网易 → npm 官方。
+默认 npm 探测候选（按优先级，延迟相同取靠前）：阿里云 npmmirror → 腾讯云 → 华为云 → npm 官方。
 
 | 变量 | 说明 |
 |------|------|
@@ -75,52 +78,15 @@ npx -y @ada-mcp/mcp-server
 - `--install-deps-force`
 - `--geckodriver-version=latest` `--chromedriver-version=match-chrome`
 
-示例：安装全部依赖后再连 MCP：
-
-```json
-{
-  "mcpServers": {
-    "ada-mcp": {
-      "command": "pnpm",
-      "args": ["dlx", "@ada-mcp/mcp-server", "--install-deps=all"]
-    }
-  }
-}
-```
-
-仅 Playwright（默认，可省略 `env`）：
+在标准 `args` 后追加，例如安装全部依赖：
 
 ```json
-{
-  "mcpServers": {
-    "ada-mcp": {
-      "command": "pnpm",
-      "args": ["dlx", "@ada-mcp/mcp-server"],
-      "env": {
-        "ADA_MCP_INSTALL_DEPS": "playwright"
-      }
-    }
-  }
-}
+"args": ["dlx", "@ada-mcp/launcher@0.1.2", "--install-deps=all"]
 ```
 
-## Cursor MCP 配置（本地 stdio）
+## Cursor MCP 配置
 
-**推荐（pnpm）：**
-
-```json
-{
-  "mcpServers": {
-    "ada-mcp": {
-      "command": "pnpm",
-      "args": ["dlx", "@ada-mcp/launcher"]
-```
-
-或 `["dlx", "@ada-mcp/mcp-server@0.1.5"]`（依赖安装走 preinstall 探测，无需 `npm_config_registry`）
-    }
-  }
-}
-```
+与上文**标准配置**相同：`pnpm` + `dlx @ada-mcp/launcher@0.1.2`。
 
 Windows 若找不到 `pnpm`，可写完整路径，例如 `C:\\Users\\<你>\\AppData\\Roaming\\npm\\pnpm.cmd`，或改用 npx：
 

package/dist/cli.cjs

@@ -23,6 +23,10 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 
+// src/bootstrap-deps.ts
+var import_node_fs2 = __toESM(require("node:fs"));
+var import_node_path10 = __toESM(require("node:path"));
+
 // ../ada-agent/dist/config.js
 var import_promises2 = __toESM(require("node:fs/promises"), 1);
 var import_node_path2 = __toESM(require("node:path"), 1);
@@ -6514,6 +6518,26 @@ function resolveBootstrapInstallDeps(argv2) {
   if (nativeDir) extras.nativeDriversDir = nativeDir;
   return { skip: false, scopes, force, extras };
 }
+function applyPreinstallPlaywrightHostFile() {
+  if (process.env.PLAYWRIGHT_DOWNLOAD_HOST?.trim()) {
+    return;
+  }
+  const roots = [process.env.INIT_CWD, process.cwd()].filter(
+    (x) => typeof x === "string" && x.trim().length > 0
+  );
+  for (const root of roots) {
+    const file = import_node_path10.default.join(root, ".ada-mcp-playwright-host");
+    try {
+      const host = import_node_fs2.default.readFileSync(file, "utf8").trim();
+      if (host.length > 0) {
+        process.env.PLAYWRIGHT_DOWNLOAD_HOST = host;
+        console.error(`[ADA-MCP] using playwright CDN from ${file}: ${host}`);
+        return;
+      }
+    } catch {
+    }
+  }
+}
 function ensureDefaultInstallTimeouts() {
   if (!process.env.ADA_INSTALL_STRATEGY_TIMEOUT_MS?.trim()) {
     process.env.ADA_INSTALL_STRATEGY_TIMEOUT_MS = "120000";
@@ -6523,6 +6547,7 @@ function ensureDefaultInstallTimeouts() {
   }
 }
 async function runBootstrapInstallDeps(argv2) {
+  applyPreinstallPlaywrightHostFile();
   ensureDefaultInstallTimeouts();
   const plan = resolveBootstrapInstallDeps(argv2);
   if (plan.skip) {
@@ -6542,9 +6567,9 @@ async function runBootstrapInstallDeps(argv2) {
 
 // src/main.ts
 var import_promises13 = __toESM(require("node:fs/promises"));
-var import_node_fs3 = require("node:fs");
+var import_node_fs4 = require("node:fs");
 var import_node_net2 = __toESM(require("node:net"));
-var import_node_path13 = __toESM(require("node:path"));
+var import_node_path14 = __toESM(require("node:path"));
 var import_node_child_process5 = require("node:child_process");
 var import_node_url4 = require("node:url");
 var import_server = require("@modelcontextprotocol/sdk/server/index.js");
@@ -6552,8 +6577,8 @@ var import_stdio = require("@modelcontextprotocol/sdk/server/stdio.js");
 var import_types = require("@modelcontextprotocol/sdk/types.js");
 
 // src/executor.ts
-var import_node_fs2 = require("node:fs");
-var import_node_path10 = __toESM(require("node:path"));
+var import_node_fs3 = require("node:fs");
+var import_node_path11 = __toESM(require("node:path"));
 var import_node_url3 = require("node:url");
 var import_meta = {};
 function ensureBundledPluginDir() {
@@ -6562,16 +6587,16 @@ function ensureBundledPluginDir() {
   }
   const candidates = [];
   try {
-    const here = import_node_path10.default.dirname((0, import_node_url3.fileURLToPath)(import_meta.url));
-    candidates.push(import_node_path10.default.join(here, "..", "plugins"));
+    const here = import_node_path11.default.dirname((0, import_node_url3.fileURLToPath)(import_meta.url));
+    candidates.push(import_node_path11.default.join(here, "..", "plugins"));
   } catch {
   }
   const dirname = globalThis.__dirname;
   if (typeof dirname === "string") {
-    candidates.push(import_node_path10.default.join(dirname, "..", "plugins"));
+    candidates.push(import_node_path11.default.join(dirname, "..", "plugins"));
   }
   for (const dir of candidates) {
-    if ((0, import_node_fs2.existsSync)(dir)) {
+    if ((0, import_node_fs3.existsSync)(dir)) {
       process.env.ADA_PLUGIN_DIR = dir;
       return;
     }
@@ -6607,30 +6632,30 @@ async function closeAllSessions() {
 
 // src/config.ts
 var import_promises11 = __toESM(require("node:fs/promises"));
-var import_node_path11 = __toESM(require("node:path"));
+var import_node_path12 = __toESM(require("node:path"));
 
 // src/bundled-config.generated.ts
-var bundledDefaultConfigYaml2 = 'agent:\r\n  id: "ada-agent-local"\r\n  mode: "foreground"\r\n  setupOnFirstRun: true\r\n\r\nbootstrapUI:\r\n  enabled: true\r\n  mode: "auto" # auto | cli | gui\r\n  host: "127.0.0.1"\r\n  port: 17650\r\n  autoOpenBrowser: true\r\n  sessionTtlSec: 600\r\n  secretsProvider: "auto" # auto | keychain | credman | file\r\n  native:\r\n    enabled: false\r\n    command: "" # e.g. ./bootstrap-ui / .\\bootstrap-ui.exe\r\n    args: []\r\n    timeoutMs: 120000\r\n    fallbackToWeb: true\r\n\r\ntransport:\r\n  mode: "auto"\r\n  streamProtocol: "websocket"\r\n  requestPath: "/api/v1/execute"\r\n  healthPath: "/health"\r\n  streamPath: "/ws"\r\n  requestTimeoutMs: 15000\r\n\r\ngraphics:\r\n  enabled: false\r\n  fallbackOnSemanticFailure: false\r\n  minConfidence: 0.8\r\n\r\nmonitoring:\r\n  enabled: false\r\n  platforms: ["web", "android", "ios", "harmony"] # \u53EF\u9009\u5B50\u96C6\r\n  sampleEvery: 1 # \u6BCF N \u6761\u64CD\u4F5C\u91C7\u6837\u4E00\u6B21\uFF0C1 \u8868\u793A\u5168\u91CF\r\n  outputDir: "artifacts/monitoring"\r\n  onFailureOnly: false # true \u65F6\u4EC5\u5931\u8D25\u64CD\u4F5C\u6293\u56FE\uFF0C\u6027\u80FD\u66F4\u4F18\r\n  groupBySession: true # \u6309 sessionId/requestId \u5206\u5C42\u5F52\u6863\r\n  nonBlocking: true # true \u65F6\u76D1\u63A7\u5F02\u6B65\u6267\u884C\uFF0C\u4E0D\u963B\u585E\u4E3B\u94FE\u8DEF\r\n  resolution:\r\n    maxWidth: 1280\r\n    maxHeight: 720\r\n    keepAspectRatio: true # \u4FDD\u6301\u6BD4\u4F8B\uFF0C\u907F\u514D\u76D1\u63A7\u56FE\u50CF\u53D8\u5F62\r\n\r\nqueue:\r\n  inboxDir: "tasks/inbox"\r\n  processedDir: "tasks/processed"\r\n  failedDir: "tasks/failed"\r\n  pollIntervalMs: 3000\r\n  maxFileRetryAttempts: 2\r\n\r\ndependencies:\r\n  autoInstallOnStart: true\r\n  playwrightBrowser: "chromium" # chromium | firefox | webkit | all\r\n  playwrightInstallTargets: ["chrome"] # chromium | chrome | msedge | firefox | webkit | all\r\n  playwrightDownloadHost: "https://npmmirror.com/mirrors/playwright"\r\n  # \u56FD\u5185 npm \u955C\u50CF\uFF08\u6309\u4F18\u5148\u7EA7\uFF1Binstall-deps \u542F\u52A8\u65F6\u6D4B\u901F\u9009\u6700\u5FEB\uFF0C\u65E0\u9700\u7528\u6237\u914D\u7F6E\uFF09\r\n  npmRegistryCandidates:\r\n    - "https://registry.npmmirror.com" # \u963F\u91CC\u4E91 / npmmirror\uFF08\u63A8\u8350\uFF09\r\n    - "https://mirrors.cloud.tencent.com/npm" # \u817E\u8BAF\u4E91\r\n    - "https://mirrors.tuna.tsinghua.edu.cn/npm" # \u6E05\u534E\u5927\u5B66\r\n    - "https://repo.huaweicloud.com/repository/npm" # \u534E\u4E3A\u4E91\r\n    - "https://mirrors.163.com/npm" # \u7F51\u6613\r\n    - "https://registry.npmjs.org" # \u5B98\u65B9\u515C\u5E95\r\n  playwrightHostCandidates:\r\n    - "https://npmmirror.com/mirrors/playwright"\r\n    - "https://playwright.azureedge.net"\r\n  # \u539F\u751F WebDriver\uFF08geckodriver / chromedriver\uFF09\u7EDF\u4E00\u653E\u5728\u9879\u76EE dirver \u76EE\u5F55\r\n  nativeDriversDir: "dirver"\r\n  geckodriverVersion: "latest" # \u5982 0.36.0\uFF1Binstall-deps --only=selenium \u65F6\u4E0B\u8F7D\u5230\u6B64\u76EE\u5F55\r\n  chromedriverVersion: "latest" # \u5982 137\u3001135\u3001match-chrome\uFF08\u5339\u914D\u672C\u673A Chrome \u4E3B\u7248\u672C\uFF09\r\n\r\nappium:\r\n  serverUrl: "http://127.0.0.1:4723"\r\n  requiredDrivers: ["uiautomator2", "xcuitest", "harmonyos"]\r\n';
+var bundledDefaultConfigYaml2 = 'agent:\r\n  id: "ada-agent-local"\r\n  mode: "foreground"\r\n  setupOnFirstRun: true\r\n\r\nbootstrapUI:\r\n  enabled: true\r\n  mode: "auto" # auto | cli | gui\r\n  host: "127.0.0.1"\r\n  port: 17650\r\n  autoOpenBrowser: true\r\n  sessionTtlSec: 600\r\n  secretsProvider: "auto" # auto | keychain | credman | file\r\n  native:\r\n    enabled: false\r\n    command: "" # e.g. ./bootstrap-ui / .\\bootstrap-ui.exe\r\n    args: []\r\n    timeoutMs: 120000\r\n    fallbackToWeb: true\r\n\r\ntransport:\r\n  mode: "auto"\r\n  streamProtocol: "websocket"\r\n  requestPath: "/api/v1/execute"\r\n  healthPath: "/health"\r\n  streamPath: "/ws"\r\n  requestTimeoutMs: 15000\r\n\r\ngraphics:\r\n  enabled: false\r\n  fallbackOnSemanticFailure: false\r\n  minConfidence: 0.8\r\n\r\nmonitoring:\r\n  enabled: false\r\n  platforms: ["web", "android", "ios", "harmony"] # \u53EF\u9009\u5B50\u96C6\r\n  sampleEvery: 1 # \u6BCF N \u6761\u64CD\u4F5C\u91C7\u6837\u4E00\u6B21\uFF0C1 \u8868\u793A\u5168\u91CF\r\n  outputDir: "artifacts/monitoring"\r\n  onFailureOnly: false # true \u65F6\u4EC5\u5931\u8D25\u64CD\u4F5C\u6293\u56FE\uFF0C\u6027\u80FD\u66F4\u4F18\r\n  groupBySession: true # \u6309 sessionId/requestId \u5206\u5C42\u5F52\u6863\r\n  nonBlocking: true # true \u65F6\u76D1\u63A7\u5F02\u6B65\u6267\u884C\uFF0C\u4E0D\u963B\u585E\u4E3B\u94FE\u8DEF\r\n  resolution:\r\n    maxWidth: 1280\r\n    maxHeight: 720\r\n    keepAspectRatio: true # \u4FDD\u6301\u6BD4\u4F8B\uFF0C\u907F\u514D\u76D1\u63A7\u56FE\u50CF\u53D8\u5F62\r\n\r\nqueue:\r\n  inboxDir: "tasks/inbox"\r\n  processedDir: "tasks/processed"\r\n  failedDir: "tasks/failed"\r\n  pollIntervalMs: 3000\r\n  maxFileRetryAttempts: 2\r\n\r\ndependencies:\r\n  autoInstallOnStart: true\r\n  playwrightBrowser: "chromium" # chromium | firefox | webkit | all\r\n  playwrightInstallTargets: ["chromium"] # chromium | chrome | msedge | firefox | webkit | all\r\n  playwrightDownloadHost: "https://cdn.playwright.dev"\r\n  # \u56FD\u5185 npm \u955C\u50CF\uFF08\u6309\u4F18\u5148\u7EA7\uFF1Binstall-deps \u542F\u52A8\u65F6\u6D4B\u901F\u9009\u6700\u5FEB\uFF0C\u65E0\u9700\u7528\u6237\u914D\u7F6E\uFF09\r\n  npmRegistryCandidates:\r\n    - "https://registry.npmmirror.com" # \u963F\u91CC\u4E91 / npmmirror\uFF08\u63A8\u8350\uFF09\r\n    - "https://mirrors.cloud.tencent.com/npm" # \u817E\u8BAF\u4E91\r\n    - "https://repo.huaweicloud.com/repository/npm" # \u534E\u4E3A\u4E91\r\n    - "https://registry.npmjs.org" # \u5B98\u65B9\u515C\u5E95\r\n  playwrightHostCandidates:\r\n    - "https://cdn.playwright.dev"\r\n    - "https://playwright.azureedge.net"\r\n    - "https://npmmirror.com/mirrors/playwright"\r\n    - "https://cdn.npmmirror.com/binaries/playwright"\r\n  # \u539F\u751F WebDriver\uFF08geckodriver / chromedriver\uFF09\u7EDF\u4E00\u653E\u5728\u9879\u76EE dirver \u76EE\u5F55\r\n  nativeDriversDir: "dirver"\r\n  geckodriverVersion: "latest" # \u5982 0.36.0\uFF1Binstall-deps --only=selenium \u65F6\u4E0B\u8F7D\u5230\u6B64\u76EE\u5F55\r\n  chromedriverVersion: "latest" # \u5982 137\u3001135\u3001match-chrome\uFF08\u5339\u914D\u672C\u673A Chrome \u4E3B\u7248\u672C\uFF09\r\n\r\nappium:\r\n  serverUrl: "http://127.0.0.1:4723"\r\n  requiredDrivers: ["uiautomator2", "xcuitest", "harmonyos"]\r\n';
 
 // src/config.ts
-var DEFAULT_CONFIG_RELATIVE2 = import_node_path11.default.join("config", "default.yaml");
-var LOCAL_DATA_DIR2 = import_node_path11.default.join(".ada-agent");
-var EFFECTIVE_CONFIG_FILE2 = import_node_path11.default.join(LOCAL_DATA_DIR2, "agent.config.yaml");
+var DEFAULT_CONFIG_RELATIVE2 = import_node_path12.default.join("config", "default.yaml");
+var LOCAL_DATA_DIR2 = import_node_path12.default.join(".ada-agent");
+var EFFECTIVE_CONFIG_FILE2 = import_node_path12.default.join(LOCAL_DATA_DIR2, "agent.config.yaml");
 async function resolveWorkspaceRoot4(startDir = process.cwd()) {
   return resolveWorkspaceRoot(DEFAULT_CONFIG_RELATIVE2, startDir);
 }
 async function loadAgentConfig(cwd = process.cwd()) {
   let root = await resolveWorkspaceRoot4(cwd);
-  const defaultPath = import_node_path11.default.join(root, DEFAULT_CONFIG_RELATIVE2);
+  const defaultPath = import_node_path12.default.join(root, DEFAULT_CONFIG_RELATIVE2);
   let defaultRaw;
   try {
     defaultRaw = await import_promises11.default.readFile(defaultPath, "utf8");
   } catch {
     defaultRaw = bundledDefaultConfigYaml2;
-    root = import_node_path11.default.dirname(process.execPath);
+    root = import_node_path12.default.dirname(process.execPath);
   }
   const defaultConfig2 = jsYaml.load(defaultRaw) ?? {};
-  const effectivePath = import_node_path11.default.join(root, EFFECTIVE_CONFIG_FILE2);
+  const effectivePath = import_node_path12.default.join(root, EFFECTIVE_CONFIG_FILE2);
   try {
     const effectiveFile = await import_promises11.default.readFile(effectivePath, "utf8");
     const effectiveConfig = jsYaml.load(effectiveFile) ?? {};
@@ -6642,7 +6667,7 @@ async function loadAgentConfig(cwd = process.cwd()) {
 
 // src/monitoring.ts
 var import_promises12 = __toESM(require("node:fs/promises"));
-var import_node_path12 = __toESM(require("node:path"));
+var import_node_path13 = __toESM(require("node:path"));
 var import_jimp2 = require("jimp");
 function getScreenshotPath2(result) {
   const value = result.data?.screenshot;
@@ -6650,9 +6675,9 @@ function getScreenshotPath2(result) {
 }
 function buildOutputPath(options, command) {
   if (options.groupBySession) {
-    return import_node_path12.default.join(options.outputDir, command.sessionId, `${command.requestId}.png`);
+    return import_node_path13.default.join(options.outputDir, command.sessionId, `${command.requestId}.png`);
   }
-  return import_node_path12.default.join(options.outputDir, `${command.requestId}.png`);
+  return import_node_path13.default.join(options.outputDir, `${command.requestId}.png`);
 }
 async function captureMcpMonitor(command, result, options, runCommand4) {
   if (!options.enabled) {
@@ -6682,7 +6707,7 @@ async function captureMcpMonitor(command, result, options, runCommand4) {
     return null;
   }
   const targetPath = buildOutputPath(options, command);
-  await import_promises12.default.mkdir(import_node_path12.default.dirname(targetPath), { recursive: true });
+  await import_promises12.default.mkdir(import_node_path13.default.dirname(targetPath), { recursive: true });
   const image = await import_jimp2.Jimp.read(sourcePath);
   if (options.keepAspectRatio) {
     image.scaleToFit({ w: options.maxWidth, h: options.maxHeight });
@@ -6726,8 +6751,8 @@ function parseServerEndpoint(serverUrl) {
   return { host, port };
 }
 function commandAvailable(command) {
-  if (import_node_path13.default.isAbsolute(command)) {
-    return (0, import_node_fs3.existsSync)(command);
+  if (import_node_path14.default.isAbsolute(command)) {
+    return (0, import_node_fs4.existsSync)(command);
   }
   const checker = process.platform === "win32" ? "where.exe" : "which";
   const checked = (0, import_node_child_process5.spawnSync)(checker, [command], {
@@ -6766,12 +6791,12 @@ function spawnDetachedChecked(cmd, args, env) {
 }
 function resolveAppiumNodeEntrypoint() {
   const candidates = [
-    import_node_path13.default.join(process.cwd(), "node_modules", "appium", "build", "lib", "main.js"),
-    import_node_path13.default.join(process.cwd(), "..", "node_modules", "appium", "build", "lib", "main.js"),
-    import_node_path13.default.join(process.cwd(), "..", "..", "node_modules", "appium", "build", "lib", "main.js")
+    import_node_path14.default.join(process.cwd(), "node_modules", "appium", "build", "lib", "main.js"),
+    import_node_path14.default.join(process.cwd(), "..", "node_modules", "appium", "build", "lib", "main.js"),
+    import_node_path14.default.join(process.cwd(), "..", "..", "node_modules", "appium", "build", "lib", "main.js")
   ];
   for (const p of candidates) {
-    if ((0, import_node_fs3.existsSync)(p)) {
+    if ((0, import_node_fs4.existsSync)(p)) {
       return p;
     }
   }
@@ -6786,15 +6811,15 @@ function loadPersistedHomes() {
     return persistedHomesCache;
   }
   const candidates = [
-    import_node_path13.default.join(process.cwd(), ".ada-agent", "deps-install-state.json"),
-    import_node_path13.default.join(process.cwd(), "..", ".ada-agent", "deps-install-state.json")
+    import_node_path14.default.join(process.cwd(), ".ada-agent", "deps-install-state.json"),
+    import_node_path14.default.join(process.cwd(), "..", ".ada-agent", "deps-install-state.json")
   ];
   for (const file of candidates) {
-    if (!(0, import_node_fs3.existsSync)(file)) {
+    if (!(0, import_node_fs4.existsSync)(file)) {
       continue;
     }
     try {
-      const raw = (0, import_node_fs3.readFileSync)(file, "utf8");
+      const raw = (0, import_node_fs4.readFileSync)(file, "utf8");
       const parsed = JSON.parse(raw);
       const androidHome = typeof parsed.androidHome === "string" ? parsed.androidHome.trim() : "";
       const appiumHome = typeof parsed.appiumHome === "string" ? parsed.appiumHome.trim() : "";
@@ -6817,36 +6842,36 @@ function resolveAndroidSdkRoot() {
     shell: false
   });
   const adbPath = (adbLookup.stdout ?? "").split(/\r?\n/).map((line) => line.trim()).find(Boolean);
-  const adbSdkRoot = adbPath ? import_node_path13.default.dirname(import_node_path13.default.dirname(adbPath)) : null;
+  const adbSdkRoot = adbPath ? import_node_path14.default.dirname(import_node_path14.default.dirname(adbPath)) : null;
   const candidates = [
     process.env.ANDROID_SDK_ROOT,
     process.env.ANDROID_HOME,
     persisted.androidHome,
     adbSdkRoot,
-    process.env.LOCALAPPDATA ? import_node_path13.default.join(process.env.LOCALAPPDATA, "Android", "Sdk") : null,
-    process.env.USERPROFILE ? import_node_path13.default.join(process.env.USERPROFILE, "AppData", "Local", "Android", "Sdk") : null
+    process.env.LOCALAPPDATA ? import_node_path14.default.join(process.env.LOCALAPPDATA, "Android", "Sdk") : null,
+    process.env.USERPROFILE ? import_node_path14.default.join(process.env.USERPROFILE, "AppData", "Local", "Android", "Sdk") : null
   ].map((v) => typeof v === "string" ? v.trim() : "").filter(Boolean);
   for (const sdkRoot of candidates) {
-    if (persisted.androidHome && sdkRoot === persisted.androidHome && (0, import_node_fs3.existsSync)(sdkRoot)) {
+    if (persisted.androidHome && sdkRoot === persisted.androidHome && (0, import_node_fs4.existsSync)(sdkRoot)) {
       return sdkRoot;
     }
-    const platformTools = import_node_path13.default.join(sdkRoot, "platform-tools");
-    if ((0, import_node_fs3.existsSync)(platformTools)) {
+    const platformTools = import_node_path14.default.join(sdkRoot, "platform-tools");
+    if ((0, import_node_fs4.existsSync)(platformTools)) {
       return sdkRoot;
     }
   }
   return null;
 }
 function getAppiumExtensionsFile(homeDir) {
-  return import_node_path13.default.join(homeDir, "node_modules", ".cache", "appium", "extensions.yaml");
+  return import_node_path14.default.join(homeDir, "node_modules", ".cache", "appium", "extensions.yaml");
 }
 function hasAppiumDriver(homeDir, driverName) {
   const file = getAppiumExtensionsFile(homeDir);
-  if (!(0, import_node_fs3.existsSync)(file)) {
+  if (!(0, import_node_fs4.existsSync)(file)) {
     return false;
   }
   try {
-    const text = (0, import_node_fs3.readFileSync)(file, "utf8");
+    const text = (0, import_node_fs4.readFileSync)(file, "utf8");
     return text.toLowerCase().includes(driverName.toLowerCase());
   } catch {
     return false;
@@ -6859,7 +6884,7 @@ function resolveAppiumHome(platform) {
     persisted.appiumHome,
     process.cwd(),
     process.env.USERPROFILE,
-    process.env.USERPROFILE ? import_node_path13.default.join(process.env.USERPROFILE, ".appium") : null
+    process.env.USERPROFILE ? import_node_path14.default.join(process.env.USERPROFILE, ".appium") : null
   ].map((v) => typeof v === "string" ? v.trim() : "").filter(Boolean);
   const uniq = Array.from(new Set(candidates));
   const targetDriver = platform === "android" ? "uiautomator2" : platform === "ios" ? "xcuitest" : "harmonyos";
@@ -6869,7 +6894,7 @@ function resolveAppiumHome(platform) {
     }
   }
   for (const candidate of uniq) {
-    if ((0, import_node_fs3.existsSync)(getAppiumExtensionsFile(candidate))) {
+    if ((0, import_node_fs4.existsSync)(getAppiumExtensionsFile(candidate))) {
       return candidate;
     }
   }
@@ -8206,7 +8231,7 @@ function wireAdaMcpProtocolServer(mcp) {
       if (!file) {
         throw new Error("file is required");
       }
-      const taskPath = import_node_path13.default.isAbsolute(file) ? file : import_node_path13.default.resolve(process.cwd(), file);
+      const taskPath = import_node_path14.default.isAbsolute(file) ? file : import_node_path14.default.resolve(process.cwd(), file);
       const tasks = await loadTaskFile2(taskPath);
       const results = await runTaskset2(tasks);
       const monitor = parseMonitorOptions(args);
@@ -8330,6 +8355,14 @@ async function startMcpServer() {
     console.error('[ADA-MCP] warning: standalone ada-mcp binary does not require "mcp" arg; it is safe to remove.');
   }
   const configHint = {
+    mcpServers: {
+      "ada-mcp": {
+        command: "pnpm",
+        args: ["dlx", "@ada-mcp/launcher@0.1.2"]
+      }
+    }
+  };
+  const binaryHint = {
     mcpServers: {
       "ada-mcp": {
         command: binaryCommand,
@@ -8338,8 +8371,6 @@ async function startMcpServer() {
         env: {
           ADA_PLAYWRIGHT_HEADLESS: "true",
           ADA_MCP_INSTALL_DEPS: "playwright",
-          ADA_NPM_PROXY_REGISTRY: "https://registry.npmmirror.com",
-          ADA_PNPM_PROXY_REGISTRY: "https://registry.npmmirror.com",
           ADA_INSTALL_STRATEGY_TIMEOUT_MS: "120000",
           ADA_PLAYWRIGHT_INSTALL_TIMEOUT_MS: "900000"
         }
@@ -8354,8 +8385,10 @@ async function startMcpServer() {
       }
     }
   };
-  console.error("[ADA-MCP] config hint (binary):");
+  console.error("[ADA-MCP] config hint (npm standard):");
   console.error(JSON.stringify(configHint, null, 2));
+  console.error("[ADA-MCP] config hint (local binary):");
+  console.error(JSON.stringify(binaryHint, null, 2));
   console.error("[ADA-MCP] note: MCP tool names use ada_snake_case (e.g. ada_install_deps, ada_invoke, ada_web_action)");
   console.error("[ADA-MCP] config hint (npm dev):");
   console.error(JSON.stringify(npmDevHint, null, 2));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ada-mcp/mcp-server",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "ADA MCP server for web/mobile automation (stdio + remote HTTP)",
   "private": false,
   "type": "commonjs",
@@ -12,12 +12,13 @@
   "files": [
     "dist/cli.cjs",
     "plugins",
-    "scripts/preinstall-registry.mjs",
+    "scripts/preinstall-probes.mjs",
     "scripts/registry-probe.mjs",
+    "scripts/playwright-probe.mjs",
     "README.md"
   ],
   "scripts": {
-    "preinstall": "node scripts/preinstall-registry.mjs",
+    "preinstall": "node scripts/preinstall-probes.mjs",
     "dev": "tsx src/cli.ts",
     "prebuild": "node ../../scripts/generate-bundled-config.mjs",
     "build": "tsc -p tsconfig.json",

package/scripts/playwright-probe.mjs

@@ -0,0 +1,98 @@
+/**
+ * Playwright 浏览器 CDN 测速（零依赖，与 dependency-installer 逻辑对齐）
+ */
+export const DEFAULT_PLAYWRIGHT_HOST_CANDIDATES = [
+  "https://cdn.playwright.dev",
+  "https://playwright.azureedge.net",
+  "https://npmmirror.com/mirrors/playwright",
+  "https://cdn.npmmirror.com/binaries/playwright"
+];
+
+function normalizeHostUrl(url) {
+  return String(url).replace(/\/$/, "");
+}
+
+/** 每个候选可尝试多个探测 URL（npmmirror 根路径常探测失败） */
+export function playwrightProbeUrls(host) {
+  const h = normalizeHostUrl(host);
+  if (h.includes("npmmirror.com/mirrors/playwright")) {
+    return [h, "https://cdn.npmmirror.com/binaries/playwright"];
+  }
+  return [h];
+}
+
+export function playwrightHostCandidateList() {
+  const configured = normalizeHostUrl(
+    process.env.PLAYWRIGHT_DOWNLOAD_HOST?.trim() || DEFAULT_PLAYWRIGHT_HOST_CANDIDATES[0]
+  );
+  const extra = process.env.ADA_PLAYWRIGHT_HOST_CANDIDATES?.trim()
+    ? process.env.ADA_PLAYWRIGHT_HOST_CANDIDATES.split(",").map((x) => normalizeHostUrl(x.trim())).filter(Boolean)
+    : [];
+  const ordered = [configured, ...DEFAULT_PLAYWRIGHT_HOST_CANDIDATES, ...extra];
+  const seen = new Set();
+  const out = [];
+  for (const url of ordered) {
+    const n = normalizeHostUrl(url);
+    if (!seen.has(n)) {
+      seen.add(n);
+      out.push(n);
+    }
+  }
+  return out;
+}
+
+async function probeUrlLatency(url) {
+  const started = Date.now();
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), 5000);
+  try {
+    const response = await fetch(url, {
+      method: "GET",
+      redirect: "manual",
+      signal: controller.signal
+    });
+    if (response.status >= 200 && response.status < 500) {
+      return Date.now() - started;
+    }
+    return null;
+  } catch {
+    return null;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+async function probePlaywrightHostLatency(host) {
+  const urls = playwrightProbeUrls(host);
+  let best = null;
+  for (const url of urls) {
+    const latency = await probeUrlLatency(url);
+    if (latency !== null && (best === null || latency < best)) {
+      best = latency;
+    }
+  }
+  return best;
+}
+
+export async function detectBestPlaywrightHost(candidates = playwrightHostCandidateList()) {
+  const probeResults = await Promise.all(
+    candidates.map(async (candidate) => ({
+      candidate,
+      latency: await probePlaywrightHostLatency(candidate)
+    }))
+  );
+  let best = candidates[0] ?? DEFAULT_PLAYWRIGHT_HOST_CANDIDATES[0];
+  let bestLatency = Number.POSITIVE_INFINITY;
+  let bestPriority = Number.POSITIVE_INFINITY;
+  for (const { candidate, latency } of probeResults) {
+    if (latency === null) continue;
+    const priority = candidates.indexOf(candidate);
+    const prio = priority >= 0 ? priority : Number.POSITIVE_INFINITY;
+    if (latency < bestLatency || (latency === bestLatency && prio < bestPriority)) {
+      best = candidate;
+      bestLatency = latency;
+      bestPriority = prio;
+    }
+  }
+  return { best: normalizeHostUrl(best), candidates, probeResults };
+}

package/scripts/preinstall-probes.mjs

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+/**
+ * pnpm dlx 安装本包时：preinstall 测速 registry + Playwright CDN，写入 .npmrc 与 .ada-mcp-playwright-host
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { detectBestRegistry, registryCandidateList } from "./registry-probe.mjs";
+import { detectBestPlaywrightHost, playwrightHostCandidateList } from "./playwright-probe.mjs";
+
+function installRoot() {
+  const init = process.env.INIT_CWD?.trim();
+  if (init && fs.existsSync(init)) {
+    return init;
+  }
+  return process.cwd();
+}
+
+function shouldRunProbe() {
+  if (process.env.ADA_MCP_SKIP_REGISTRY_PROBE === "1") {
+    return false;
+  }
+  if (process.env.ADA_MCP_FORCE_PREINSTALL_PROBE === "1") {
+    return true;
+  }
+  const init = (process.env.INIT_CWD || "").replace(/\\/g, "/");
+  if (/[\\/]dlx[\\/]/.test(init) || init.includes("__npx")) {
+    return true;
+  }
+  if (init) {
+    try {
+      if (fs.existsSync(path.join(init, "pnpm-workspace.yaml"))) {
+        return false;
+      }
+    } catch {
+      // ignore
+    }
+  }
+  return init.length > 0;
+}
+
+async function main() {
+  if (!shouldRunProbe()) {
+    return;
+  }
+  const root = installRoot();
+
+  const regCandidates = registryCandidateList();
+  const reg = await detectBestRegistry(regCandidates);
+  const npmrcPath = path.join(root, ".npmrc");
+  const regLine = `registry=${reg.best}\n`;
+  let npmrc = "";
+  try {
+    npmrc = fs.readFileSync(npmrcPath, "utf8");
+  } catch {
+    // new
+  }
+  if (!npmrc.includes(`registry=${reg.best}`)) {
+    fs.writeFileSync(npmrcPath, `${npmrc}${regLine}`, "utf8");
+  }
+  console.error(`[ada-mcp preinstall] registry: ${reg.best}`);
+  for (const { candidate, latency } of reg.probeResults) {
+    console.error(`[ada-mcp preinstall]   registry ${candidate} -> ${latency === null ? "fail" : `${latency}ms`}`);
+  }
+
+  const pwCandidates = playwrightHostCandidateList();
+  const pw = await detectBestPlaywrightHost(pwCandidates);
+  const hostFile = path.join(root, ".ada-mcp-playwright-host");
+  fs.writeFileSync(hostFile, `${pw.best}\n`, "utf8");
+  process.env.PLAYWRIGHT_DOWNLOAD_HOST = pw.best;
+  console.error(`[ada-mcp preinstall] playwright CDN: ${pw.best} (wrote ${hostFile})`);
+  for (const { candidate, latency } of pw.probeResults) {
+    console.error(`[ada-mcp preinstall]   playwright ${candidate} -> ${latency === null ? "fail" : `${latency}ms`}`);
+  }
+}
+
+main().catch((error) => {
+  console.error("[ada-mcp preinstall] probe failed:", error);
+  process.exit(0);
+});

package/scripts/registry-probe.mjs

@@ -4,9 +4,7 @@
 export const DEFAULT_NPM_REGISTRY_CANDIDATES = [
   "https://registry.npmmirror.com",
   "https://mirrors.cloud.tencent.com/npm",
-  "https://mirrors.tuna.tsinghua.edu.cn/npm",
   "https://repo.huaweicloud.com/repository/npm",
-  "https://mirrors.163.com/npm",
   "https://registry.npmjs.org"
 ];
 

package/scripts/preinstall-registry.mjs

@@ -1,70 +0,0 @@
-#!/usr/bin/env node
-/**
- * pnpm dlx / npm install 本包时：在安装 dependencies 之前测速并写入 .npmrc，
- * 使同一次安装中的 playwright 等依赖走最快 registry。
- */
-import fs from "node:fs";
-import path from "node:path";
-import { detectBestRegistry, registryCandidateList } from "./registry-probe.mjs";
-
-function installRoot() {
-  const init = process.env.INIT_CWD?.trim();
-  if (init && fs.existsSync(init)) {
-    return init;
-  }
-  return process.cwd();
-}
-
-function shouldRunProbe() {
-  if (process.env.ADA_MCP_SKIP_REGISTRY_PROBE === "1") {
-    return false;
-  }
-  if (process.env.ADA_MCP_FORCE_PREINSTALL_PROBE === "1") {
-    return true;
-  }
-  const init = (process.env.INIT_CWD || "").replace(/\\/g, "/");
-  if (/[\\/]dlx[\\/]/.test(init) || init.includes("__npx")) {
-    return true;
-  }
-  if (init) {
-    try {
-      if (fs.existsSync(path.join(init, "pnpm-workspace.yaml"))) {
-        return false;
-      }
-    } catch {
-      // ignore
-    }
-  }
-  return init.length > 0;
-}
-
-async function main() {
-  if (!shouldRunProbe()) {
-    return;
-  }
-  const root = installRoot();
-  const candidates = registryCandidateList();
-  const { best, probeResults } = await detectBestRegistry(candidates);
-  const npmrcPath = path.join(root, ".npmrc");
-  const line = `registry=${best}\n`;
-  let existing = "";
-  try {
-    existing = fs.readFileSync(npmrcPath, "utf8");
-  } catch {
-    // new file
-  }
-  if (!existing.includes(`registry=${best}`)) {
-    fs.writeFileSync(npmrcPath, `${existing}${line}`, "utf8");
-  }
-  console.error(
-    `[ada-mcp preinstall] registry probe: selected ${best} (candidates: ${candidates.join(", ")})`
-  );
-  for (const { candidate, latency } of probeResults) {
-    console.error(`[ada-mcp preinstall]   ${candidate} -> ${latency === null ? "fail" : `${latency}ms`}`);
-  }
-}
-
-main().catch((error) => {
-  console.error("[ada-mcp preinstall] registry probe failed:", error);
-  process.exit(0);
-});