CDP 소켓을 통해 AI agent가 로컬의 Chromium 브라우저 및 Electron 데스크톱 애플리케이션을 제어할 수 있게 하는 자동화 엔진입니다.
다른 이름 Weavetab/mcp, mcp, @weavetab/mcp
- 스타
- 3
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 2.5.0
- 마지막 커밋
- 2026년 11월 7일
- 라이선스
- AGPL-3.0
Weavetab MCP란?
CDP 소켓을 통해 AI agent가 로컬의 Chromium 브라우저 및 Electron 데스크톱 애플리케이션을 제어할 수 있게 하는 자동화 엔진입니다.
프로젝트 README에서 생성된 요약
Weavetab MCP server 정보
Weavetab은 AI agent가 실시간 Chromium 브라우저 및 Electron 데스크톱 애플리케이션과 상호작용할 수 있도록 설계된 자동화 엔진을 제공합니다. 로컬 Chrome DevTools Protocol 소켓에 직접 연결함으로써 WebDriver 바이너리나 클라우드 릴레이의 오버헤드를 방지합니다. 이를 통해 로컬 환경 내에서 작업을 고속으로 실행할 수 있으며, 등록된 Electron 프로세스를 통해 Discord, VS Code, Figma와 같은 애플리케이션을 지원합니다.
개발자는 stdio 또는 로컬 WebSocket 데몬을 사용하여 이 MCP server를 Claude Desktop, Cursor 또는 Windsurf와 같은 MCP client에 통합할 수 있습니다. 이 시스템은 Semantic Map 3.0을 사용하여 웹 페이지를 압축된 agent 가독 형식으로 변환하며, delta diffing을 통해 토큰 소비를 최대 95%까지 절감합니다. 보안은 도메인 정책, 역할 기반 액세스 제어 및 민감한 인증 정보가 LLM context에 유입되는 것을 방지하는 blind injection 시스템을 통해 로컬에서 처리됩니다.
표준 웹 탐색을 넘어, 이 도구 모음은 인간과 유사한 마우스 움직임을 위한 Ghost Cursor 및 API 없이 CAPTCHA를 해결하는 zero-API 접근 방식과 같은 특화된 기능을 포함합니다. 엄격한 개인정보 보호와 낮은 지연 시간이 필요한 고정밀 자동화 사용자들을 위해 구축되었습니다.
활용 사례
- 1데스크톱 애플리케이션 워크플로 자동화에이전트가 명령을 특정 Electron 프로세스로 라우팅하여 Discord 또는 VS Code와 같이 설치된 데스크톱 소프트웨어 내부에서 작업을 수행할 수 있습니다.
- 2민감한 인증 정보의 안전한 처리모델이 실제 비밀번호나 토큰을 전혀 보지 못한 상태에서 AI가 서비스에 로그인하도록 지시할 수 있습니다.
- 3봇 탐지 메커니즘 우회인간의 물리적인 마우스 움직임과 가속도를 모방하여 복잡한 CAPTCHA를 통과할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Weavetab MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Weavetab MCP 설치
$ claude mcp add mcp -- npx -y @weavetab/mcpCursor에 Weavetab MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@weavetab/mcp"
]
}
}
}VS Code에 Weavetab MCP 설치
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@weavetab/mcp"
]
}
}
}VS Code CLI에 Weavetab MCP 설치
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@weavetab/mcp"]}'Claude Desktop에 Weavetab MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@weavetab/mcp"
]
}
}
}Codex에 Weavetab MCP 설치
$ codex mcp add mcp -- npx -y @weavetab/mcpCodex config.toml에 Weavetab MCP 설치
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@weavetab/mcp"]
Gemini CLI에 Weavetab MCP 설치
$ gemini mcp add -s user mcp npx -- -y @weavetab/mcpGemini settings.json에 Weavetab MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@weavetab/mcp"
]
}
}
}자동 검사
2026년 11월 14일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능weavetab/mcp is public and reachablegithub.com/weavetab/mcp ↗통과
- 패키지가 이 저장소를 소스로 명시@weavetab/mcp names weavetab/mcp as sourcenpmjs.com/package/@weavetab/mcp ↗통과
- 빌드 출처(Sigstore 증명)No build attestation published for this release검사되지 않음
- 오픈 소스 라이선스 (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-07github.com/weavetab/mcp ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from @weavetab/mcp통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음264 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기Weavetab 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.
Weavetab MCP 질문
Weavetab MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add mcp -- npx -y @weavetab/mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Weavetab MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
Weavetab은 Playwright나 Puppeteer와 어떻게 다른가요?
표준 방식과 달리 Weavetab은 오버헤드를 낮추기 위해 직접적인 CDP WebSocket 연결을 사용하며, Electron 데스크톱 앱을 지원합니다. 또한 Semantic Map 3.0을 사용하여 토큰 사용량을 최대 95%까지 줄입니다.
Weavetab으로 데스크톱 애플리케이션을 제어할 수 있나요?
네, 설정에 애플리케이션 경로를 등록하면 Discord, VS Code, Figma와 같은 모든 Electron 기반 애플리케이션을 제어할 수 있습니다.
민감한 인증 정보는 어떻게 처리하나요?
Blind Injection 방식을 사용합니다. 비밀 정보는 서버 측에서 해결되며 LLM context, DOM 스냅샷 또는 감사 로그에 절대 포함되지 않습니다.
CAPTCHA 해결을 위해 외부 서비스를 사용해야 하나요?
아니요, 별도의 third-party API 없이 CDP 마우스 이벤트를 통해 인간의 행동 패턴을 복제함으로써 CAPTCHA를 해결합니다.