Mesin otomasi yang memungkinkan AI agent mengontrol browser Chromium live dan aplikasi desktop Electron secara lokal melalui socket CDP.
Juga dikenal sebagai Weavetab/mcp, mcp, @weavetab/mcp
- Stars
- 3
- Tools
- —
- Unduhan, 30 hari
- —
- Versi terbaru
- 2.5.0
- Commit terakhir
- 7 Nov 2026
- Lisensi
- AGPL-3.0
Apa itu Weavetab MCP?
Mesin otomasi yang memungkinkan AI agent mengontrol browser Chromium live dan aplikasi desktop Electron secara lokal melalui socket CDP.
Ringkasan dibuat dari README proyek
Tentang Weavetab MCP server
Weavetab menyediakan mesin otomasi yang dirancang agar AI agent dapat berinteraksi dengan browser Chromium live dan aplikasi desktop Electron. Dengan terhubung langsung ke socket Chrome DevTools Protocol lokal, sistem ini menghindari overhead dari binary WebDriver atau cloud relay. Hal ini memungkinkan eksekusi tugas berkecepatan tinggi di dalam lingkungan lokal, mendukung aplikasi seperti Discord, VS Code, atau Figma melalui proses Electron yang terdaftar.
Developer dapat mengintegrasikan MCP server ini ke dalam client MCP seperti Claude Desktop, Cursor, atau Windsurf menggunakan stdio atau daemon WebSocket lokal. Sistem ini menggunakan Semantic Map 3.0 untuk menerjemahkan halaman web ke dalam format ringkas yang mudah dibaca oleh agent, yang mengurangi konsumsi token hingga 95% melalui metode delta diffing. Keamanan ditangani secara lokal melalui kebijakan domain, role-based access control, dan sistem blind injection yang mencegah kredensial sensitif masuk ke dalam konteks LLM.
Selain navigasi web standar, toolset ini mencakup kemampuan khusus seperti Ghost Cursor untuk pergerakan mouse yang menyerupai manusia dan pendekatan zero-API untuk menyelesaikan CAPTCHA. Tool ini dibangun untuk pengguna yang membutuhkan otomasi dengan fidelitas tinggi, privasi ketat, dan latensi rendah.
Apa yang bisa Anda lakukan dengannya
- 1Otomasi workflow aplikasi desktopSeorang agent dapat melakukan tindakan di dalam software desktop yang terinstal seperti Discord atau VS Code dengan mengarahkan perintah ke proses Electron tertentu.
- 2Menangani kredensial sensitif secara amanAnda dapat menginstruksikan AI untuk login ke berbagai layanan tanpa model tersebut melihat password atau token yang sebenarnya.
- 3Melewati mekanisme deteksi botMesin ini dapat menavigasi CAPTCHA yang kompleks dengan meniru pergerakan fisik mouse dan akselerasi manusia.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal Weavetab MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal Weavetab MCP di Claude Code
$ claude mcp add mcp -- npx -y @weavetab/mcpInstal Weavetab MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@weavetab/mcp"
]
}
}
}Instal Weavetab MCP di VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@weavetab/mcp"
]
}
}
}Instal Weavetab MCP di VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@weavetab/mcp"]}'Instal Weavetab MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@weavetab/mcp"
]
}
}
}Instal Weavetab MCP di Codex
$ codex mcp add mcp -- npx -y @weavetab/mcpInstal Weavetab MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@weavetab/mcp"]
Instal Weavetab MCP di Gemini CLI
$ gemini mcp add -s user mcp npx -- -y @weavetab/mcpInstal Weavetab MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@weavetab/mcp"
]
}
}
}Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Lolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkauweavetab/mcp is public and reachablegithub.com/weavetab/mcp ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernya@weavetab/mcp names weavetab/mcp as sourcenpmjs.com/package/@weavetab/mcp ↗Lolos
- Provenance build (atestasi Sigstore)No build attestation published for this releaseTidak diperiksa
- Lisensi open source (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-11-07github.com/weavetab/mcp ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerNo popular package one edit away from @weavetab/mcpLolos
- Tidak ada advisory kritis pada paket atau dependensinya264 resolved dependencies checked; no critical advisoryosv.dev ↗Lolos
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di GitHubWeavetab is the open automation engine for AI agents. It connects models directly to live Chromium browsers and Electron desktop applications via native Chrome DevTools Protocol (CDP) sockets — no WebDriver binaries, no cloud relay, zero telemetry.
Actions execute directly over local CDP sockets without external driver overhead. Web pages are translated into agent-readable semantic maps with turn-by-turn diffing that reduces token usage by up to 95%. Built-in security enforces local domain policies, role-based access control, and client-side credential injection.
Built by Weavetab, architected by fy2ne.
Why not Playwright or Puppeteer?
The standard approach — Playwright over MCP — works. But it carries fundamental architectural costs that compound at scale.
| Playwright / Puppeteer | Weavetab | |
|---|---|---|
| Protocol layer | WebDriver BiDi or CDP via browser binary | Direct CDP WebSocket |
| Tool execution overhead | 50–300 ms (binary + IPC overhead) | In-process (direct local socket) |
| Desktop app control | Browser only | Chrome + any Electron app (Discord, VS Code, Figma…) |
| DOM representation | Full HTML dump to LLM | Semantic Map 3.0 with delta diffing |
| Token cost per map | ~2,000–8,000 tokens | ~80–400 tokens (95% reduction via delta) |
| CAPTCHA | API service required | Zero-API via CDP mouse physics |
| Credential safety | Secrets passed in plaintext | Blind Injection — never in LLM context |
| Extension access | Limited | Full Chrome Extension API surface |
Architecture
MCP Client (Claude / Cursor / Antigravity / Copilot / Windsurf)
|
| JSON-RPC 2.0 (stdio or WebSocket 127.0.0.1:3000)
v
+-------------------------------------------------------------+
| Weavetab MCP Server |
| |
| +-----------------+ +---------------------------------+ |
| | Security Layer |-->| Intelligence Engine | |
| | Rate · RBAC | | Map 3.0 · Delta · Memory | |
| | Policy · Audit | | Pruner · Framework Detector | |
| +-----------------+ +----------------+----------------+ |
| | |
| +----------v----------------+ |
| | CDP Bridge | |
| | Ghost Cursor · Typing | |
| | App Router · Loop Guard | |
| +----------+----------------+ |
+-------------------------------------------------------------+
| CDP WebSocket (127.0.0.1)
+---------------------------+-----------------------------+
v v v
Chrome / Edge VS Code / Discord Your Electron App
(any tab) (Electron apps) (local dev)
No cloud. No external process. Both the CDP WebSocket connection and the optional MCP WebSocket daemon (--ws) are strictly bound to 127.0.0.1 with shared-secret authentication (~/.weavetab-system/ws-secret) and Origin/Host header verification.
Quick Start
npx -y @weavetab/mcp
Add to your MCP client config:
{
"mcpServers": {
"weavetab": {
"command": "npx",
"args": ["-y", "@weavetab/mcp"]
}
}
}
| Client | Config path |
|---|---|
| Claude Desktop | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Claude Code | claude mcp add weavetab -- npx -y @weavetab/mcp |
| Cursor | .cursor/mcp.json |
| Antigravity | ~/.gemini/antigravity/mcp/weavetab/ |
| VS Code Copilot | .vscode/mcp.json |
| Windsurf | ~/.codeium/windsurf/mcp_config.json |
Core Technology
Semantic Map 3.0
The primary bottleneck in browser-based agents is DOM representation. Full HTML dumps are noisy, large, and structurally meaningless to language models. Weavetab's browser_map runs an in-browser CDP walker that produces a compact semantic map:
╔═ ACTIVE DIALOG: "Confirm Payment" ═╗
[w:3] button "Confirm" [w:4] button "Cancel"
┌ "Pro Plan — $49/mo"
[w:12] button "Upgrade" [w:13] button "View Details"
[w:14] input val:"john@example.com" ph:"Email address" FOCUSED
[w:20...w:38] 18 nav links: "Dashboard" ... "Sign out"
Key properties:
- Ref IDs (
w:N) are stable within a session and used by all interaction tools - Container binding — buttons and inputs are grouped under their parent card, row, or section header
- Modal hoisting — open dialogs are isolated at the top so agents cannot miss them
- Link collapsing — repeated nav/footer runs of 4+ links compress into a single token line
- Semantic delta — on re-reads, only changed nodes are transmitted (
~modified,+added,−removed), cutting re-read cost by up to 95%
Ghost Cursor
Clicks are not dispatched as synthetic DOM events. They are delivered as a physical sequence of Input.dispatchMouseEvent CDP calls along a Bezier curve trajectory with randomized acceleration, natural jitter, and hold durations. Anti-bot fingerprinting that flags event-based automation does not trigger.
browser_pointer supports hover_chain for multi-level menu traversal in a single tool call:
{
"hover_chain": ["File", "Export As", "PNG"],
"click_final": true
}
Blind Credential Injection
browser_type_secret resolves secrets server-side from ~/.weavetab/secrets.json. The resolved value is never included in the MCP response, never appears in DOM snapshots, and is permanently masked as [REDACTED] in all audit logs. The LLM context never sees the credential.
weavetab secrets set GITHUB_TOKEN
# Stored. Never echoed, never logged, never surfaced to the agent.
Electron & Desktop App Automation
Any tool accepts an optional app parameter that routes the command to a registered Electron process instead of a browser tab:
{ "app": "discord", "ref": "w:24", "text": "Hey, deploying now" }
Register apps in ~/.weavetab/config.json:
{
"electron": {
"discord": "C:\\Users\\<user>\\AppData\\Local\\Discord\\Discord.exe",
"vscode": "C:\\Users\\<user>\\AppData\\Local\\Programs\\Microsoft VS Code\\Code.exe",
"figma": "C:\\Users\\<user>\\AppData\\Local\\Figma\\Figma.exe"
}
}
Weavetab auto-attaches via CDP to the registered process. No code changes required in the target application.
Zero-API CAPTCHA Solving
browser_captcha solves Cloudflare Turnstile, reCAPTCHA v2/v3, GeeTest, and hCaptcha by orchestrating CDP mouse events that replicate human behavioral signatures — velocity curves, micro-pauses, scroll inertia — with no third-party API, no external service, and no API key required.
Tool Suite
41 tools across 9 categories. Full parameter reference: docs/tools/tools.md
| Category | Tools |
|---|---|
| Vision & DOM | browser_map browser_find browser_scrape browser_inspect browser_snapshot browser_screenshot browser_console browser_extract_design |
| Input & Interaction | browser_click browser_type browser_type_secret browser_key browser_pointer browser_select browser_fill browser_upload browser_scroll |
| Navigation & Environment | browser_navigate browser_tabs browser_detect browser_viewport browser_emulate |
| Mission & Automation | browser_burst browser_automation browser_recording browser_pattern_learn |
| Safety & Human Oversight | browser_dialog browser_thoughts browser_clipboard browser_wait |
| Autonomous CAPTCHA | browser_captcha |
| Network & Storage | browser_network_intercept browser_storage browser_cookies browser_checkpoint browser_performance |
| Office Documents | browser_office |
| Canvas & Eval | browser_eval browser_pdf browser_canvas browser_highlight |
Security
- Transport: Both CDP WebSocket and MCP WebSocket daemon (
--ws) are strictly bound to127.0.0.1with 256-bit shared-secret Bearer/handshake authentication andOrigin/Hostvalidation. No listener on external interfaces. - Policy Engine: Per-domain
allow/read-only/deny/auditrules under the top-levelpoliciesarray in~/.weavetab/config.json(blocks*.bank.*andpaypal.comout of the box) - RBAC: Five roles —
operator(default),viewer(least-privilege read-only),automation,system,admin— enforce tool-level permission gates - Plugin Trust & Manifests: 3-tier verification (
@weavetab/*official, verified registry allowlist, and mandatory interactive confirmation +weavetab.jsonpermission manifest inspection for unverified packages) - Blind Injection: Credentials resolved server-side, masked in all outputs and audit logs
- Loop Breaker: Strike-based stuck-loop detector halts runaway autonomous sequences
- Audit Log: All tool invocations, policy decisions, and errors written to
~/.weavetab-system/logs/mission_<timestamp>.log
Security vulnerabilities: security@weavetab.dev (do not use public issues).
CLI Reference
weavetab # Start in stdio mode (default)
weavetab --ws --port 3000 # WebSocket daemon mode (bound to 127.0.0.1)
weavetab config # Interactive configuration wizard
weavetab secrets set KEY_NAME # Store a secret (never echoed)
weavetab secrets list # List stored secret keys (not values)
weavetab plugin add <name> # Install a verified/confirmed plugin
weavetab plugin update <name> # Interactively upgrade an installed plugin
weavetab plugin list # List installed plugins
Configuration file: ~/.weavetab/config.json
{
"browserType": "chromium",
"headless": false,
"extension": true,
"maxActionsPerMinute": 60,
"role": "operator",
"electron": {
"discord": "...",
"vscode": "...",
"antigravity": "..."
}
}
Extensibility
Weavetab exposes a typed Plugin SDK for authoring custom MCP tools, HUD overlays, and tool lifecycle hooks:
npx @weavetab/sdk init my-plugin
See docs/PLUGINS.md for architecture, manifest spec, and SDK API reference.
License
AGPL-3.0-only. Client connections over stdio or WebSocket do not extend copyleft obligations to your client application or models.
For commercial embedding, closed-source SaaS, or proprietary enterprise licensing, see COMMERCIAL.md or contact license@weavetab.dev.
Pertanyaan tentang Weavetab MCP
Bagaimana cara menambahkan Weavetab MCP ke Claude Code?
Jalankan claude mcp add mcp -- npx -y @weavetab/mcp di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan Weavetab MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Apa perbedaan Weavetab dengan Playwright atau Puppeteer?
Berbeda dengan pendekatan standar, Weavetab menggunakan koneksi WebSocket CDP secara langsung untuk overhead yang lebih rendah, mendukung aplikasi desktop Electron, dan menggunakan Semantic Map 3.0 untuk mengurangi penggunaan token hingga 95%.
Apakah Weavetab bisa mengontrol aplikasi desktop?
Ya, Weavetab dapat mengontrol aplikasi berbasis Electron seperti Discord, VS Code, atau Figma dengan mendaftarkan path aplikasi di dalam konfigurasi.
Bagaimana cara menangani kredensial sensitif?
Weavetab menggunakan Blind Injection, di mana rahasia (secrets) diselesaikan di sisi server dan tidak pernah disertakan dalam konteks LLM, snapshot DOM, atau log audit.
Apakah memerlukan layanan eksternal untuk menyelesaikan CAPTCHA?
Tidak, Weavetab menyelesaikan CAPTCHA dengan mereplikasi tanda perilaku manusia melalui event mouse CDP tanpa memerlukan API pihak ketiga.