@ada-mcp/mcp-server 0.1.4 → 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
 ```
@@ -45,8 +53,9 @@ npx -y @ada-mcp/mcp-server
 
 | 阶段 | 自动探测最快镜像 |
 |------|------------------|
-| `pnpm dlx` / `npx` 拉 MCP 包 | 否 — 用 `npm_config_registry` 或 `pnpm dlx --registry …` |
-| 启动后 `install-deps` | 是 — 内置五家国内镜像 + 官方源测速选最快（**无需配置**） |
+| `pnpm dlx @ada-mcp/launcher` | **是** — 拉包前测速（推荐） |
+| `pnpm dlx @ada-mcp/mcp-server` | tarball 仍走本机源；**同次安装的依赖**由 `preinstall` 测速（0.1.5+） |
+| 启动后 `install-deps` | 是 — 内置五家国内镜像测速（**无需配置**） |
 
 默认 npm 探测候选（按优先级，延迟相同取靠前）：阿里云 npmmirror → 腾讯云 → 清华 → 华为云 → 网易 → npm 官方。
 
@@ -104,10 +113,10 @@ npx -y @ada-mcp/mcp-server
   "mcpServers": {
     "ada-mcp": {
       "command": "pnpm",
-      "args": ["dlx", "@ada-mcp/mcp-server@0.1.3"],
-      "env": {
-        "npm_config_registry": "https://registry.npmmirror.com"
-      }
+      "args": ["dlx", "@ada-mcp/launcher"]
+```
+
+或 `["dlx", "@ada-mcp/mcp-server@0.1.5"]`（依赖安装走 preinstall 探测，无需 `npm_config_registry`）
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ada-mcp/mcp-server",
-  "version": "0.1.4",
+  "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 };
+}