AI agent'larının canlı Chromium tarayıcılarını ve Electron masaüstü uygulamalarını CDP soketleri aracılığıyla yerel olarak kontrol etmesini sağlayan bir otomasyon motoru.
Ayrıca bilinen adı Weavetab/mcp, mcp, @weavetab/mcp
- Yıldızlar
- 3
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- 2.5.0
- Son commit
- 7 Kas 2026
- Lisans
- AGPL-3.0
Weavetab MCP nedir?
AI agent'larının canlı Chromium tarayıcılarını ve Electron masaüstü uygulamalarını CDP soketleri aracılığıyla yerel olarak kontrol etmesini sağlayan bir otomasyon motoru.
Özet, projenin README dosyasından oluşturuldu
Weavetab MCP sunucusu hakkında
Weavetab, AI agent'larının canlı Chromium tarayıcıları ve Electron masaüstü uygulamalarıyla etkileşime girmesi için tasarlanmış bir otomasyon motoru sunar. Yerel Chrome DevTools Protocol soketlerine doğrudan bağlanarak WebDriver binary'lerinin veya bulut aktarıcılarının getirdiği ek yükten kaçınır. Bu say sayesinde, kayıtlı Electron süreçleri aracılığıyla Discord, VS Code veya Figma gibi uygulamaları destekleyerek yerel ortamlarda yüksek hızlı görev yürütme imkanı sağlar.
Geliştiriciler, bu sunucuyu stdio veya yerel bir WebSocket daemon kullanarak Claude Desktop, Cursor veya Windsurf gibi MCP istemcilerine entegre edebilirler. Sistem, web sayfalarını kompakt ve agent tarafından okunabilir formatlara dönüştürmek için Semantic Map 3.0 kullanır; bu da delta diffing yöntemiyle token tüketimini %95'e kadar azaltır. Güvenlik; alan politikaları, rol tabanlı erişim kontrolü ve hassas kimlik bilgilerinin LLM bağlamına girmesini engelleyen bir blind injection sistemi aracılığıyla yerel olarak yönetilir.
Standart web navigasyonunun ötesinde araç seti, insan benzeri fare hareketleri için Ghost Cursor ve CAPTCHA çözmek için API gerektirmeyen bir yaklaşım gibi özel yetenekler içerir. Katı gizlilik ve düşük gecikme süresi ile yüksek sadakatli otomasyon gerektiren kullanıcılar için oluşturulmuştur.
Neler yapabilirsiniz
- 1Masaüstü uygulama iş akışlarını otomatize edinBir agent, komutları belirli bir Electron sürecine yönlendirerek Discord veya VS Code gibi yüklü masaüstü yazılımları içinde işlemler gerçekleştirebilir.
- 2Hassas kimlik bilgilerini güvenli bir şekilde yönetinModelin gerçek şifreyi veya token'ı hiçbir zaman görmemesini sağlayarak bir AI'ya servislere giriş yapması talimatını verebilirsiniz.
- 3Bot tespit mekanizmalarını aşınMotor, insan benzeri fiziksel fare hareketlerini ve ivmelenmesini taklit ederek karmaşık CAPTCHA'lar arasında gezinebilir.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Weavetab MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleWeavetab MCP'yi Claude Code içine yükleyin
$ claude mcp add mcp -- npx -y @weavetab/mcpWeavetab MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@weavetab/mcp"
]
}
}
}Weavetab MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@weavetab/mcp"
]
}
}
}Weavetab MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@weavetab/mcp"]}'Weavetab MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@weavetab/mcp"
]
}
}
}Weavetab MCP'yi Codex içine yükleyin
$ codex mcp add mcp -- npx -y @weavetab/mcpWeavetab MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@weavetab/mcp"]
Weavetab MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user mcp npx -- -y @weavetab/mcpWeavetab MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@weavetab/mcp"
]
}
}
}Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirweavetab/mcp is public and reachablegithub.com/weavetab/mcp ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyor@weavetab/mcp names weavetab/mcp as sourcenpmjs.com/package/@weavetab/mcp ↗Geçti
- Derleme kökeni (Sigstore onayı)No build attestation published for this releaseKontrol edilmedi
- Açık kaynak lisansı (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-11-07github.com/weavetab/mcp ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from @weavetab/mcpGeçti
- Pakette veya bağımlılıklarında kritik uyarı yok264 resolved dependencies checked; no critical advisoryosv.dev ↗Geçti
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
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 soruları
Weavetab MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add mcp -- npx -y @weavetab/mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
Weavetab MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Weavetab'ın Playwright veya Puppeteer'dan farkı nedir?
Standart yaklaşımların aksine Weavetab, daha düşük yük oluşturmak için doğrudan CDP WebSocket bağlantılarını kullanır, Electron masaüstü uygulamalarını destekler ve token kullanımını %95'e kadar azaltmak için Semantic Map 3.0 teknolojisinden yararlanır.
Weavetab masaüstü uygulamalarını kontrol edebilir mi?
Evet, uygulama yolunu konfigürasyona kaydederek Discord, VS Code veya Figma gibi Electron tabanlı herhangi bir uygulamayı kontrol edebilir.
Hassas kimlik bilgilerini nasıl yönetiyor?
Sırların sunucu tarafında çözüldüğü ve LLM bağlamına, DOM anlık görüntülerine veya denetim günlüklerine asla dahil edilmediği Blind Injection yöntemini kullanır.
CAPTCHA çözmek için harici servislere ihtiyaç duyuyor mu?
Hayır, üçüncü taraf API'lere ihtiyaç duymadan, CDP fare olayları aracılığıyla insan davranışsal imzalarını taklit ederek CAPTCHA'ları çözer.