CDPソケットを介して、AIエージェントがローカルのChromiumブラウザやElectronデスクトップアプリケーションを制御できるようにするオートメーションエンジンです。
別名 Weavetab/mcp, mcp, @weavetab/mcp
- スター
- 3
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- 2.5.0
- 最終コミット
- 2026年11月7日
- ライセンス
- AGPL-3.0
Weavetab MCPとは
CDPソケットを介して、AIエージェントがローカルのChromiumブラウザやElectronデスクトップアプリケーションを制御できるようにするオートメーションエンジンです。
プロジェクトのREADMEから生成された概要
Weavetab MCP server について
Weavetabは、AIエージェントがライブのChromiumブラウザやElectronデスクトップアプリケーションと対話するために設計されたオートメーションエンジンを提供します。ローカルのChrome DevTools Protocolソケットに直接接続することで、WebDriverバイナリやクラウドリレーのオーバーヘッドを回避します。これにより、ローカル環境内でのタスクを高速に実行でき、登録されたElectronプロセスを通じてDiscord、VS Code、Figmaなどのアプリケーションをサポートします。
開発者は、stdioまたはローカルのWebSocketデーモンを使用して、このサーバーをClaude Desktop、Cursor、WindsurfなどのMCPクライアントに統合できます。システムはSemantic Map 3.0を使用してウェブページをコンパクトでエージェントが読み取りやすい形式に変換し、デルタ差分(delta diffing)を通じてトークン消費量を最大95%削減します。セキュリティは、ドメインポリシー、ロールベースのアクセス制御、および機密情報がLLMコンテキストに入るのを防ぐBlind Injectionシステムによってローカルで管理されます。
標準的なウェブナビゲーションに加え、このツールセットには、人間のようなマウスの動きを実現するGhost Cursorや、APIを使用せずにCAPTCHAを解決するアプローチなどの専門的な機能が含まれています。厳格なプライバシーと低レイテンシを必要とする、高精度なオートメーションを求めるユーザー向けに構築されています。
できること
- 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を開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
WeavetabはPlaywrightやPuppeteerと何が違うのですか?
標準的な手法とは異なり、Weavetabは直接的なCDP WebSocket接続を使用するためオーバーヘッドが低く、Electronデスクトップアプリをサポートしています。また、Semantic Map 3.0を使用することで、トークン使用量を最大95%削減できます。
Weavetabでデスクトップアプリケーションを制御できますか?
はい、設定にアプリケーションのパスを登録することで、Discord、VS Code、FigmaなどのElectronベースのアプリケーションを制御できます。
機密性の高い認証情報はどのように扱われますか?
Blind Injectionを採用しています。これにより、シークレットはサーバー側で解決され、LLMのコンテキスト、DOMスナップショット、または監査ログには一切含まれません。
CAPTCHAを解決するために外部サービスが必要ですか?
いいえ、サードパーティのAPIを使用することなく、CDPマウスイベントを通じて人間の行動シグネチャを再現することでCAPTCHAを解決します。