@ada-mcp/mcp-server 0.1.6 → 0.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +20 -53
  2. package/dist/cli.cjs +12 -4
  3. package/package.json +1 -1
  4. package/scripts/registry-probe.mjs +0 -2
package/README.md CHANGED
@@ -6,24 +6,27 @@ ADA MCP server package that supports:
6
6
  - Remote HTTP mode (`server`) with API key authentication
7
7
  - MCP **Streamable HTTP** on `POST|GET|DELETE /mcp` (same port as legacy REST), with optional SSE per MCP spec (`@modelcontextprotocol/sdk` transport)
8
8
 
9
- ## Run with pnpm（推荐，尤其 Windows）
9
+ ## 标准安装（Cursor / MCP）
10
10
 
11
- **全程自动选最快镜像（推荐）：**
11
+ 请使用 **`@ada-mcp/launcher@0.1.2`** 拉起本包（见 [launcher README](../ada-mcp-launcher/README.md)）：
12
12
 
13
- ```bash
14
- pnpm dlx @ada-mcp/launcher
13
+ ```json
14
+ {
15
+ "mcpServers": {
16
+ "ada-mcp": {
17
+ "command": "pnpm",
18
+ "args": ["dlx", "@ada-mcp/launcher@0.1.2"]
19
+ }
20
+ }
21
+ }
15
22
  ```
16
23
 
17
- 或直接（`0.1.6+`：`preinstall` 测速 registry + Playwright CDN，写入 `.npmrc` / `.ada-mcp-playwright-host`）：
18
-
19
- ```bash
20
- pnpm dlx @ada-mcp/mcp-server@0.1.6
21
- ```
24
+ 本包版本：**`@ada-mcp/mcp-server@0.1.6`**（由 launcher 默认拉取）。
22
25
 
23
- 也可用 npm：
26
+ 直接调试本包（无 launcher 拉包前测速）：
24
27
 
25
28
  ```bash
26
- npx -y @ada-mcp/mcp-server
29
+ pnpm dlx @ada-mcp/mcp-server@0.1.6
27
30
  ```
28
31
 
29
32
  ## 启动时自动安装依赖（默认仅 Playwright）
@@ -55,9 +58,9 @@ npx -y @ada-mcp/mcp-server
55
58
  |------|------------------|
56
59
  | `pnpm dlx @ada-mcp/launcher` | **是** — 拉包前测速（推荐） |
57
60
  | `pnpm dlx @ada-mcp/mcp-server` | tarball 仍走本机源；**同次安装的依赖**由 `preinstall` 测速（0.1.5+） |
58
- | 启动后 `install-deps` | 是 — 内置五家国内镜像测速（**无需配置**） |
61
+ | 启动后 `install-deps` | 是 — 内置国内镜像测速（**无需配置**） |
59
62
 
60
- 默认 npm 探测候选（按优先级，延迟相同取靠前）：阿里云 npmmirror → 腾讯云 → 清华 → 华为云 → 网易 → npm 官方。
63
+ 默认 npm 探测候选（按优先级，延迟相同取靠前）：阿里云 npmmirror → 腾讯云 → 华为云 → npm 官方。
61
64
 
62
65
  | 变量 | 说明 |
63
66
  |------|------|
@@ -75,51 +78,15 @@ npx -y @ada-mcp/mcp-server
75
78
  - `--install-deps-force`
76
79
  - `--geckodriver-version=latest` `--chromedriver-version=match-chrome`
77
80
 
78
- 示例：安装全部依赖后再连 MCP：
81
+ 在标准 `args` 后追加，例如安装全部依赖：
79
82
 
80
83
  ```json
81
- {
82
- "mcpServers": {
83
- "ada-mcp": {
84
- "command": "pnpm",
85
- "args": ["dlx", "@ada-mcp/mcp-server", "--install-deps=all"]
86
- }
87
- }
88
- }
84
+ "args": ["dlx", "@ada-mcp/launcher@0.1.2", "--install-deps=all"]
89
85
  ```
90
86
 
91
- 仅 Playwright（默认，可省略 `env`）：
92
-
93
- ```json
94
- {
95
- "mcpServers": {
96
- "ada-mcp": {
97
- "command": "pnpm",
98
- "args": ["dlx", "@ada-mcp/mcp-server"],
99
- "env": {
100
- "ADA_MCP_INSTALL_DEPS": "playwright"
101
- }
102
- }
103
- }
104
- }
105
- ```
106
-
107
- ## Cursor MCP 配置（本地 stdio）
108
-
109
- **推荐（pnpm）：**
110
-
111
- ```json
112
- {
113
- "mcpServers": {
114
- "ada-mcp": {
115
- "command": "pnpm",
116
- "args": ["dlx", "@ada-mcp/launcher"]
117
- }
118
- }
119
- }
120
- ```
87
+ ## Cursor MCP 配置
121
88
 
122
- 或 `"args": ["dlx", "@ada-mcp/mcp-server@0.1.5"]`（同次 dlx 安装依赖时由 preinstall 测速，无需 `npm_config_registry`）。
89
+ 与上文**标准配置**相同：`pnpm` + `dlx @ada-mcp/launcher@0.1.2`。
123
90
 
124
91
  Windows 若找不到 `pnpm`，可写完整路径，例如 `C:\\Users\\<你>\\AppData\\Roaming\\npm\\pnpm.cmd`，或改用 npx：
125
92
 
package/dist/cli.cjs CHANGED
@@ -6635,7 +6635,7 @@ var import_promises11 = __toESM(require("node:fs/promises"));
6635
6635
  var import_node_path12 = __toESM(require("node:path"));
6636
6636
 
6637
6637
  // src/bundled-config.generated.ts
6638
- 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://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://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://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';
6638
+ 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';
6639
6639
 
6640
6640
  // src/config.ts
6641
6641
  var DEFAULT_CONFIG_RELATIVE2 = import_node_path12.default.join("config", "default.yaml");
@@ -8355,6 +8355,14 @@ async function startMcpServer() {
8355
8355
  console.error('[ADA-MCP] warning: standalone ada-mcp binary does not require "mcp" arg; it is safe to remove.');
8356
8356
  }
8357
8357
  const configHint = {
8358
+ mcpServers: {
8359
+ "ada-mcp": {
8360
+ command: "pnpm",
8361
+ args: ["dlx", "@ada-mcp/launcher@0.1.2"]
8362
+ }
8363
+ }
8364
+ };
8365
+ const binaryHint = {
8358
8366
  mcpServers: {
8359
8367
  "ada-mcp": {
8360
8368
  command: binaryCommand,
@@ -8363,8 +8371,6 @@ async function startMcpServer() {
8363
8371
  env: {
8364
8372
  ADA_PLAYWRIGHT_HEADLESS: "true",
8365
8373
  ADA_MCP_INSTALL_DEPS: "playwright",
8366
- ADA_NPM_PROXY_REGISTRY: "https://registry.npmmirror.com",
8367
- ADA_PNPM_PROXY_REGISTRY: "https://registry.npmmirror.com",
8368
8374
  ADA_INSTALL_STRATEGY_TIMEOUT_MS: "120000",
8369
8375
  ADA_PLAYWRIGHT_INSTALL_TIMEOUT_MS: "900000"
8370
8376
  }
@@ -8379,8 +8385,10 @@ async function startMcpServer() {
8379
8385
  }
8380
8386
  }
8381
8387
  };
8382
- console.error("[ADA-MCP] config hint (binary):");
8388
+ console.error("[ADA-MCP] config hint (npm standard):");
8383
8389
  console.error(JSON.stringify(configHint, null, 2));
8390
+ console.error("[ADA-MCP] config hint (local binary):");
8391
+ console.error(JSON.stringify(binaryHint, null, 2));
8384
8392
  console.error("[ADA-MCP] note: MCP tool names use ada_snake_case (e.g. ada_install_deps, ada_invoke, ada_web_action)");
8385
8393
  console.error("[ADA-MCP] config hint (npm dev):");
8386
8394
  console.error(JSON.stringify(npmDevHint, null, 2));
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ada-mcp/mcp-server",
3
- "version": "0.1.6",
3
+ "version": "0.1.7",
4
4
  "description": "ADA MCP server for web/mobile automation (stdio + remote HTTP)",
5
5
  "private": false,
6
6
  "type": "commonjs",
package/scripts/registry-probe.mjs CHANGED
@@ -4,9 +4,7 @@
4
4
  export const DEFAULT_NPM_REGISTRY_CANDIDATES = [
5
5
  "https://registry.npmmirror.com",
6
6
  "https://mirrors.cloud.tencent.com/npm",
7
- "https://mirrors.tuna.tsinghua.edu.cn/npm",
8
7
  "https://repo.huaweicloud.com/repository/npm",
9
- "https://mirrors.163.com/npm",
10
8
  "https://registry.npmjs.org"
11
9
  ];
12
10