@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.
- package/LICENSE +212 -627
- package/README.md +25 -27
- package/dist/cdp/connector.js +2 -2
- package/dist/cli/plugin.d.ts +1 -0
- package/dist/cli/plugin.js +60 -4
- package/dist/config/loader.d.ts +1 -1
- package/dist/config/loader.js +1 -1
- package/dist/index.js +42 -6
- package/dist/plugin/interface.d.ts +14 -5
- package/dist/plugin/loader.d.ts +0 -3
- package/dist/plugin/loader.js +78 -15
- package/dist/plugin/registry.d.ts +2 -1
- package/dist/plugin/registry.js +21 -12
- package/dist/security/secrets.d.ts +6 -0
- package/dist/security/secrets.js +24 -0
- package/dist/server.d.ts +1 -1
- package/dist/server.js +37 -34
- package/dist/tools/browser_detect.js +2 -2
- package/dist/tools/captcha.js +1 -1
- package/dist/tools/navigate.d.ts +1 -1
- package/dist/tools/navigate.js +5 -5
- package/dist/tools/tabs.js +1 -1
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/docs/DOCUMENTATION.md +18 -11
- package/docs/PLUGINS.md +5 -5
- package/docs/TOOLS.md +54 -56
- package/docs/architecture/overview.md +1 -1
- package/docs/architecture/security.md +36 -35
- package/docs/architecture/transport.md +37 -37
- package/docs/cli/cli-commands.md +50 -44
- package/docs/cli/cli-flags.md +28 -20
- package/docs/cli/cli-scripting.md +35 -32
- package/docs/configuration/config-locations.md +23 -24
- package/docs/configuration/env-variables.md +19 -19
- package/docs/desktop-automation/electron-apps.md +3 -6
- package/docs/get-started/introduction.md +4 -4
- package/docs/get-started/setup-wizard.md +27 -26
- package/docs/tools/tools.md +1 -1
- package/docs/troubleshooting/trouble-browser.md +27 -27
- package/icon.png +0 -0
- package/mcp.json +3 -21
- package/package.json +3 -3
- package/server.json +6 -6
- package/smithery.yaml +7 -11
|
@@ -31,18 +31,15 @@ AI Agent (MCP) ──► withSecurity()
|
|
|
31
31
|
|
|
32
32
|
---
|
|
33
33
|
|
|
34
|
-
## Interactive App Configurator
|
|
34
|
+
## Interactive App Configurator
|
|
35
35
|
|
|
36
|
-
|
|
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
|
|
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
|
-
- **
|
|
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 (
|
|
50
|
-
- **
|
|
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
|
|
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
|
|
19
|
-
|
|
20
|
-
## Wizard Phases
|
|
21
|
-
|
|
22
|
-
1. **Phase 1 — Essentials:** Browser path, RBAC role (`admin`, `
|
|
23
|
-
2. **Phase 2 — Advanced:** Browser engine selection,
|
|
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
|
|
26
|
-
5. **Phase 5 —
|
|
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.
|
package/docs/tools/tools.md
CHANGED
|
@@ -9,7 +9,7 @@ slug: tools
|
|
|
9
9
|
|
|
10
10
|
# MCP Tools Master Reference
|
|
11
11
|
|
|
12
|
-
Weavetab exposes **
|
|
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.
|
|
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": "
|
|
4
|
-
"version": "2.5.0
|
|
5
|
-
"description": "
|
|
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
|
|
4
|
-
"description": "
|
|
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": "
|
|
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": "
|
|
4
|
-
"title": "Weavetab
|
|
5
|
-
"description": "
|
|
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/
|
|
7
|
+
"url": "https://github.com/Weavetab/mcp",
|
|
8
8
|
"source": "github"
|
|
9
9
|
},
|
|
10
|
-
"version": "2.5.0
|
|
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
|
|
16
|
+
"version": "2.5.0",
|
|
17
17
|
"transport": {
|
|
18
18
|
"type": "stdio"
|
|
19
19
|
},
|
package/smithery.yaml
CHANGED
|
@@ -1,11 +1,7 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
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"
|