@weavetab/mcp 2.5.0-beta.4 → 2.5.0

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 (45) hide show
  1. package/LICENSE +212 -627
  2. package/README.md +25 -27
  3. package/dist/cdp/connector.js +2 -2
  4. package/dist/cli/plugin.d.ts +1 -0
  5. package/dist/cli/plugin.js +60 -4
  6. package/dist/config/loader.d.ts +1 -1
  7. package/dist/config/loader.js +1 -1
  8. package/dist/index.js +42 -6
  9. package/dist/plugin/interface.d.ts +14 -5
  10. package/dist/plugin/loader.d.ts +0 -3
  11. package/dist/plugin/loader.js +78 -15
  12. package/dist/plugin/registry.d.ts +2 -1
  13. package/dist/plugin/registry.js +21 -12
  14. package/dist/security/secrets.d.ts +6 -0
  15. package/dist/security/secrets.js +24 -0
  16. package/dist/server.d.ts +1 -1
  17. package/dist/server.js +37 -34
  18. package/dist/tools/browser_detect.js +2 -2
  19. package/dist/tools/captcha.js +1 -1
  20. package/dist/tools/navigate.d.ts +1 -1
  21. package/dist/tools/navigate.js +5 -5
  22. package/dist/tools/tabs.js +1 -1
  23. package/dist/version.d.ts +1 -1
  24. package/dist/version.js +1 -1
  25. package/docs/DOCUMENTATION.md +18 -11
  26. package/docs/PLUGINS.md +5 -5
  27. package/docs/TOOLS.md +54 -56
  28. package/docs/architecture/overview.md +1 -1
  29. package/docs/architecture/security.md +36 -35
  30. package/docs/architecture/transport.md +37 -37
  31. package/docs/cli/cli-commands.md +50 -44
  32. package/docs/cli/cli-flags.md +28 -20
  33. package/docs/cli/cli-scripting.md +35 -32
  34. package/docs/configuration/config-locations.md +23 -24
  35. package/docs/configuration/env-variables.md +19 -19
  36. package/docs/desktop-automation/electron-apps.md +3 -6
  37. package/docs/get-started/introduction.md +4 -4
  38. package/docs/get-started/setup-wizard.md +27 -26
  39. package/docs/tools/tools.md +1 -1
  40. package/docs/troubleshooting/trouble-browser.md +27 -27
  41. package/icon.png +0 -0
  42. package/mcp.json +3 -21
  43. package/package.json +3 -3
  44. package/server.json +6 -6
  45. package/smithery.yaml +7 -11
@@ -31,18 +31,15 @@ AI Agent (MCP) ──► withSecurity()
31
31
 
32
32
  ---
33
33
 
34
- ## Interactive App Configurator & Agent Generator
34
+ ## Interactive App Configurator
35
35
 
36
- Use the interactive configurator below to customize your desktop applications. Select presets or add custom apps, toggle between executable path strings, remote debug ports, or advanced objects, and copy the ready-to-use JSON or an automated setup prompt for your AI coding agent:
37
-
38
- ```electron-configurator
39
- ```
36
+ Build your `electron` block in the [Desktop app configurator](/mcp/desktop) — presets for Discord, VS Code, Figma, Slack and more, path / port / advanced formats, plus a copy-ready agent setup prompt. Then paste the block into your global `~/.weavetab/config.json`.
40
37
 
41
38
  ---
42
39
 
43
40
  ## 1. Configuring Desktop Apps in `config.json`
44
41
 
45
- Add an `"electron"` object to your local `./.weavetab/config.json` or global `~/.weavetab/config.json`:
42
+ Add an `"electron"` object to your global `~/.weavetab/config.json` (the only config file Weavetab reads):
46
43
 
47
44
  ```json
48
45
  {
@@ -43,11 +43,11 @@ npm install -D @weavetab/sdk@latest
43
43
 
44
44
  ## What You Get
45
45
 
46
- - **49 built-in MCP tools** covering DOM vision, input synthesis, desktop apps, tabs, network interception, office files, design extraction, and plugin lifecycle
46
+ - **44 built-in MCP tools** covering DOM vision, input synthesis, desktop apps, tabs, network interception, office files, design extraction, and plugin lifecycle
47
47
  - **Universal Desktop App Runtime** — control Chrome and native Electron apps (Discord, Figma, VS Code) side-by-side without port conflicts
48
48
  - **Autonomous Zero-API CAPTCHA Solver** — solve Cloudflare Turnstile, GeeTest, and reCAPTCHA locally via CDP mouse physics with $0 API costs
49
- - **Two transport modes** — stdio (Claude Desktop, Cursor, VS Code, Windsurf, Antigravity) and WebSocket (`--ws --port 3000`)
50
- - **Four RBAC roles** — `admin`, `operator`, `viewer`, and `automation`
49
+ - **Two transport modes** — stdio (Claude Desktop, Cursor, VS Code, Windsurf, Antigravity) and WebSocket (`weavetab --ws --port 3000`)
50
+ - **Five RBAC roles** — `admin`, `operator`, `viewer`, `automation`, and `system`
51
51
  - **Per-domain policies** — ring-fences sensitive banking, internal, and production surfaces
52
52
  - **Blind Injection** — credentials resolved server-side from `secrets.json` and never exposed to the LLM
53
53
  - **Extensible Plugin System** — auto-discovers and mounts custom MCP tools from `node_modules`
@@ -57,4 +57,4 @@ npm install -D @weavetab/sdk@latest
57
57
  - **[Quickstart](quickstart.md)** — install and run a first mission in 60 seconds
58
58
  - **[Desktop & Electron Apps](../desktop-automation/electron-apps.md)** — configure and control desktop apps
59
59
  - **[Autonomous CAPTCHA Solver](../captcha-stealth/captcha-solver.md)** — zero-API anti-bot solving
60
- - **[MCP Tools Reference](../tools/tools.md)** — full reference for all 49 built-in automation tools
60
+ - **[MCP Tools Reference](../tools/tools.md)** — full reference for all 44 built-in automation tools
@@ -1,26 +1,27 @@
1
- ---
2
- title: "Setup Wizard"
3
- description: "Interactive wizard that writes a clean config.json."
4
- product: mcp
5
- section: get-started
6
- icon: Wand2
7
- slug: setup-wizard
8
- ---
9
-
10
- # Setup Wizard
11
-
12
- Run the interactive CLI configuration wizard:
13
-
14
- ```bash
15
- weavetab config
16
- ```
17
-
18
- The wizard walks through every option across 5 interactive phases. Re-run it at any time to update your saved config.
19
-
20
- ## Wizard Phases
21
-
22
- 1. **Phase 1 — Essentials:** Browser path, RBAC role (`admin`, `operator`, `viewer`, `automation`), headless mode, dev mode, max tabs, actionability timeout, domain block/allow lists.
23
- 2. **Phase 2 — Advanced:** Browser engine selection, navigation timeouts, dark mode preferences, telemetry opt-in, outbound HTTP/SOCKS proxy, domain policy modes.
24
- 3. **Phase 3 — Save Location:** Global (`~/.weavetab/config.json`) or Project-scoped (`./.weavetab/config.json`).
25
- 4. **Phase 4 — MCP Auto-Config:** Auto-detects installed IDEs (Claude Desktop, Cursor, Windsurf, VS Code, OpenCode, Claude Code, Antigravity) and merges Weavetab into their MCP configuration.
26
- 5. **Phase 5 — Summary:** Displays full configuration validation report.
1
+ ---
2
+ title: "Setup Wizard"
3
+ description: "Interactive wizard that writes a clean config.json."
4
+ product: mcp
5
+ section: get-started
6
+ icon: Wand2
7
+ slug: setup-wizard
8
+ ---
9
+
10
+ # Setup Wizard
11
+
12
+ Run the interactive CLI configuration wizard:
13
+
14
+ ```bash
15
+ weavetab config
16
+ ```
17
+
18
+ The wizard walks through every option across 6 interactive phases. Re-run it at any time to update your saved config.
19
+
20
+ ## Wizard Phases
21
+
22
+ 1. **Phase 1 — Essentials:** Browser path, RBAC role (`admin`, `viewer`, `automation`), headless mode, dev mode, max tabs, actionability timeout, domain block/allow lists.
23
+ 2. **Phase 2 — Advanced (optional):** Browser engine selection, timeouts and rate limits, telemetry opt-in, download/proxy directories, domain policy entries.
24
+ 3. **Phase 3 — Save Location:** Global (`~/.weavetab/config.json`).
25
+ 4. **Phase 4 — MCP Auto-Config:** Auto-detects installed IDEs (Claude Desktop, Cursor, Windsurf) and merges Weavetab into their MCP configuration.
26
+ 5. **Phase 5 — Agent Skills:** Optionally installs `@weavetab/skills` for your agent framework.
27
+ 6. **Phase 6 — Summary:** Displays full configuration validation report.
@@ -9,7 +9,7 @@ slug: tools
9
9
 
10
10
  # MCP Tools Master Reference
11
11
 
12
- Weavetab exposes **49 production-grade MCP tools** engineered for sub-10ms browser automation, visual inspection, desktop app orchestration, zero-API CAPTCHA solving, and human-like interaction.
12
+ Weavetab exposes **44 production-grade MCP tools** engineered for sub-10ms browser automation, visual inspection, desktop app orchestration, zero-API CAPTCHA solving, and human-like interaction.
13
13
 
14
14
  Every tool adheres to a strict contract:
15
15
  - **Zod schema validation** for all runtime arguments
@@ -1,27 +1,27 @@
1
- ---
2
- title: "Browser Issues"
3
- description: "CDP connection failures, crashes, and extension problems."
4
- product: mcp
5
- section: troubleshooting
6
- icon: MonitorX
7
- slug: trouble-browser
8
- ---
9
-
10
- # Browser Connection Issues
11
-
12
- ## "CDP connection failed" Error
13
-
14
- **Causes:**
15
- - Port 9222 is occupied by another process
16
- - Chrome was launched without `--remote-debugging-port`
17
-
18
- **Fixes:**
19
- 1. Run `weavetab reset --yes` to terminate orphaned browser processes
20
- 2. Verify port availability: `netstat -an | grep 9222`
21
- 3. Restart Weavetab
22
-
23
- ## Browser Crashes on Launch
24
-
25
- **Fixes:**
26
- 1. Run `weavetab reset` to purge corrupted profiles
27
- 2. Check `CHROME_PATH` environment variable points to a valid Chromium executable
1
+ ---
2
+ title: "Browser Issues"
3
+ description: "CDP connection failures, crashes, and extension problems."
4
+ product: mcp
5
+ section: troubleshooting
6
+ icon: MonitorX
7
+ slug: trouble-browser
8
+ ---
9
+
10
+ # Browser Connection Issues
11
+
12
+ ## "CDP connection failed" Error
13
+
14
+ **Causes:**
15
+ - Port 9222 is occupied by another process
16
+ - Chrome was launched without `--remote-debugging-port`
17
+
18
+ **Fixes:**
19
+ 1. Run `weavetab reset --yes` to terminate orphaned browser processes
20
+ 2. Verify port availability: `netstat -an | grep 9222`
21
+ 3. Restart Weavetab
22
+
23
+ ## Browser Crashes on Launch
24
+
25
+ **Fixes:**
26
+ 1. Run `weavetab reset` to purge corrupted profiles
27
+ 2. Run `weavetab config` and set the browser executable path (or `browserPath: "auto"` to detect)
package/icon.png CHANGED
Binary file
package/mcp.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "@weavetab/mcp",
3
- "mcpName": "io.github.weavetab/mcp",
4
- "version": "2.5.0-beta.4",
5
- "description": "Weavetab MCP — Direct Layer 0 interface for AI agents across web and desktop applications. Direct socket transport, zero wrapper overhead, deterministic state execution.",
3
+ "mcpName": "dev.weavetab/mcp",
4
+ "version": "2.5.0",
5
+ "description": "The open automation engine for AI agents. Control live browsers and desktop apps locally with instant execution.",
6
6
  "icon": "icon.png",
7
7
  "author": "fy2ne",
8
8
  "license": "AGPL-3.0-only",
@@ -453,24 +453,6 @@
453
453
  "CPU throttling multipliers",
454
454
  "Geolocation and timezone overrides"
455
455
  ]
456
- },
457
- "list_plugins": {
458
- "category": "plugins",
459
- "description": "Inspect installed Weavetab SDK plugins, available unloadable plugins, tool overrides, custom schemas, and capability manifests.",
460
- "features": [
461
- "Installed plugin discovery",
462
- "Manifest and schema introspection",
463
- "Ecosystem capability listing"
464
- ]
465
- },
466
- "load_plugin": {
467
- "category": "plugins",
468
- "description": "Dynamically load any published Weavetab plugin by npm package name into the active runtime with isolated sandboxing and hot tool registration.",
469
- "features": [
470
- "Dynamic npm package loading",
471
- "Hot tool registration with client notification",
472
- "Isolated plugin execution context"
473
- ]
474
456
  }
475
457
  },
476
458
  "resources": {
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@weavetab/mcp",
3
- "version": "2.5.0-beta.4",
4
- "description": "Direct Layer 0 interface for AI agents across web and desktop applications. No WebDriver. No cloud. Pure control.",
3
+ "version": "2.5.0",
4
+ "description": "The open automation engine for AI agents. Control live browsers and desktop apps locally with instant execution.",
5
5
  "author": {
6
6
  "name": "fy2ne",
7
7
  "email": "hello@fy2ne.me",
@@ -47,7 +47,7 @@
47
47
  "publishConfig": {
48
48
  "access": "public"
49
49
  },
50
- "mcpName": "io.github.weavetab/mcp",
50
+ "mcpName": "dev.weavetab/mcp",
51
51
  "files": [
52
52
  "dist/",
53
53
  "!dist/**/*.map",
package/server.json CHANGED
@@ -1,19 +1,19 @@
1
1
  {
2
2
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
3
- "name": "io.github.weavetab/mcp",
4
- "title": "Weavetab MCP",
5
- "description": "Give AI agents full control over live browsers and apps to navigate, click, extract, and automate.",
3
+ "name": "dev.weavetab/mcp",
4
+ "title": "Weavetab",
5
+ "description": "Open automation engine for AI agents. Control live browsers and desktop apps locally.",
6
6
  "repository": {
7
- "url": "https://github.com/weavetab/mcp",
7
+ "url": "https://github.com/Weavetab/mcp",
8
8
  "source": "github"
9
9
  },
10
- "version": "2.5.0-beta.4",
10
+ "version": "2.5.0",
11
11
  "packages": [
12
12
  {
13
13
  "registryType": "npm",
14
14
  "registryBaseUrl": "https://registry.npmjs.org",
15
15
  "identifier": "@weavetab/mcp",
16
- "version": "2.5.0-beta.4",
16
+ "version": "2.5.0",
17
17
  "transport": {
18
18
  "type": "stdio"
19
19
  },
package/smithery.yaml CHANGED
@@ -1,11 +1,7 @@
1
- # Smithery.ai Universal MCP Configuration
2
- # Works automatically across Cursor, Claude Desktop, Windsurf, Continue.dev, Roo Code & Smithery CLI
3
-
4
- startCommand:
5
- type: stdio
6
- config:
7
- command: node
8
- args:
9
- - dist/index.js
10
- env:
11
- NODE_ENV: production
1
+ startCommand:
2
+ type: stdio
3
+ config:
4
+ command: npx
5
+ args:
6
+ - -y
7
+ - "@weavetab/mcp@latest"