@ada-mcp/mcp-server 0.1.3 → 0.1.5

package/README.md

@@ -8,6 +8,14 @@ ADA MCP server package that supports:
 
 ## Run with pnpm（推荐，尤其 Windows）
 
+**全程自动选最快镜像（推荐）：**
+
+```bash
+pnpm dlx @ada-mcp/launcher
+```
+
+或直接（`0.1.5+` 在同次 dlx 安装依赖时 `preinstall` 测速）：
+
 ```bash
 pnpm dlx @ada-mcp/mcp-server
 ```
@@ -25,7 +33,6 @@ npx -y @ada-mcp/mcp-server
 | 配置 | 含义 |
 |------|------|
 | （未配置） | 仅安装 **Playwright + 浏览器** |
-| `playwright` | 同上 |
 | `playwright` | 仅 Playwright（显式写法，与默认相同） |
 | `selenium` | **仅** Selenium 原生驱动（GeckoDriver/ChromeDriver） |
 | `appium` | **仅** Appium 包 + 移动端驱动 |
@@ -39,9 +46,28 @@ npx -y @ada-mcp/mcp-server
 - `ADA_MCP_SKIP_INSTALL_DEPS=1`：跳过自动安装
 - `ADA_MCP_INSTALL_DEPS_FORCE=1`：强制重装
 - `ADA_MCP_GECKODRIVER_VERSION` / `ADA_MCP_CHROMEDRIVER_VERSION`：Selenium 驱动版本
-- `ADA_PLAYWRIGHT_INSTALL_TIMEOUT_MS`：浏览器下载超时（默认 15 分钟，`0.1.2` 仅 20s 易报错）
+- `ADA_PLAYWRIGHT_INSTALL_TIMEOUT_MS`：浏览器下载超时（默认 15 分钟）
 - `ADA_INSTALL_STRATEGY_TIMEOUT_MS`：npm 装包超时（默认 2 分钟）
 
+## 代理与镜像（`0.1.3+`）
+
+| 阶段 | 自动探测最快镜像 |
+|------|------------------|
+| `pnpm dlx @ada-mcp/launcher` | **是** — 拉包前测速（推荐） |
+| `pnpm dlx @ada-mcp/mcp-server` | tarball 仍走本机源；**同次安装的依赖**由 `preinstall` 测速（0.1.5+） |
+| 启动后 `install-deps` | 是 — 内置五家国内镜像测速（**无需配置**） |
+
+默认 npm 探测候选（按优先级，延迟相同取靠前）：阿里云 npmmirror → 腾讯云 → 清华 → 华为云 → 网易 → npm 官方。
+
+| 变量 | 说明 |
+|------|------|
+| `npm_config_registry` | 可选；仅加速 **dlx** 拉包（推荐 `https://registry.npmmirror.com`） |
+| `ADA_REGISTRY_CANDIDATES` | 可选；在默认五镜像**之外**追加候选 |
+| `ADA_NPM_PROXY_REGISTRY` / `ADA_PNPM_PROXY_REGISTRY` | 可选；覆盖探测主候选（默认 npmmirror） |
+| `PLAYWRIGHT_DOWNLOAD_HOST` | 可选；Playwright 浏览器 CDN |
+
+详见 [ADA-MCP-接入手册 §3.9.2](../../docs/ADA-MCP-接入手册.md#392-代理与镜像配置)。
+
 **CLI 参数**（写在 MCP `args` 末尾）
 
 - `--install-deps=playwright,selenium`
@@ -87,7 +113,10 @@ npx -y @ada-mcp/mcp-server
   "mcpServers": {
     "ada-mcp": {
       "command": "pnpm",
-      "args": ["dlx", "@ada-mcp/mcp-server"]
+      "args": ["dlx", "@ada-mcp/launcher"]
+```
+
+或 `["dlx", "@ada-mcp/mcp-server@0.1.5"]`（依赖安装走 preinstall 探测，无需 `npm_config_registry`）
     }
   }
 }

package/dist/cli.cjs

@@ -6610,7 +6610,7 @@ var import_promises11 = __toESM(require("node:fs/promises"));
 var import_node_path11 = __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  npmRegistryCandidates:\r\n    - "https://registry.npmmirror.com"\r\n    - "https://mirrors.cloud.tencent.com/npm"\r\n    - "https://repo.huaweicloud.com/repository/npm"\r\n    - "https://registry.npmjs.org"\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: ["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';
 
 // src/config.ts
 var DEFAULT_CONFIG_RELATIVE2 = import_node_path11.default.join("config", "default.yaml");

package/package.json

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

package/scripts/preinstall-registry.mjs

@@ -0,0 +1,70 @@
+#!/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);
+});

package/scripts/registry-probe.mjs

@@ -0,0 +1,76 @@
+/**
+ * 零依赖 npm registry 测速（供 preinstall / launcher 共用）
+ */
+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"
+];
+
+function normalizeRegistryUrl(url) {
+  return String(url).replace(/\/$/, "");
+}
+
+export function registryCandidateList(extraEnv) {
+  const primary = normalizeRegistryUrl(
+    process.env.ADA_NPM_PROXY_REGISTRY?.trim() || DEFAULT_NPM_REGISTRY_CANDIDATES[0]
+  );
+  const extra = extraEnv?.trim()
+    ? extraEnv.split(",").map((x) => normalizeRegistryUrl(x.trim())).filter(Boolean)
+    : process.env.ADA_REGISTRY_CANDIDATES?.trim()
+      ? process.env.ADA_REGISTRY_CANDIDATES.split(",").map((x) => normalizeRegistryUrl(x.trim())).filter(Boolean)
+      : [];
+  const ordered = [primary, ...DEFAULT_NPM_REGISTRY_CANDIDATES, ...extra];
+  const seen = new Set();
+  const out = [];
+  for (const url of ordered) {
+    const n = normalizeRegistryUrl(url);
+    if (!seen.has(n)) {
+      seen.add(n);
+      out.push(n);
+    }
+  }
+  return out;
+}
+
+async function probeRegistryLatency(registry) {
+  const target = `${normalizeRegistryUrl(registry)}/appium`;
+  const started = Date.now();
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), 5000);
+  try {
+    const response = await fetch(target, { method: "GET", signal: controller.signal });
+    if (!response.ok) return null;
+    return Date.now() - started;
+  } catch {
+    return null;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+export async function detectBestRegistry(candidates = registryCandidateList()) {
+  const probeResults = await Promise.all(
+    candidates.map(async (candidate) => ({
+      candidate,
+      latency: await probeRegistryLatency(candidate)
+    }))
+  );
+  let best = candidates[0] ?? DEFAULT_NPM_REGISTRY_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: normalizeRegistryUrl(best), candidates, probeResults };
+}