WeaveTab MCP V2

Das Zero-Setup Local Browser MCP für KI-Agenten

npm version License: MIT Socket Badge

WeaveTab ist ein leichtgewichtiger, lokaler Model Context Protocol (MCP) Server, der es KI-Agenten ermöglicht, nahtlos mit Webbrowsern über das Chrome DevTools Protocol (CDP) zu interagieren. Im Gegensatz zu anderen Lösungen ist WeaveTab komplett autonom und erfordert kein Setup. Es startet automatisch ein isoliertes Browser-Profil parallel zu Ihrem täglichen Browser-Gebrauch – das bedeutet, Sie müssen nie wieder Ihren Browser schließen oder sich mit Debugging-Ports herumschlagen.

🌟 Hauptfunktionen

Autonomer Browser ohne Setup: Läuft komplett parallel zu Ihrem bestehenden Browser über eine isolierte Sandbox. Keine manuelle Port-Konfiguration, kein Schließen Ihres persönlichen Browsers.
Keine Erweiterungen erforderlich: Verbindet sich direkt über natives CDP.
Semantische Aktionskarte: weave_read gibt eine geparste, hochkomprimierte semantische DOM-Karte zurück, was den Token-Verbrauch erheblich reduziert.
Sniper-Modus-Aktionen: weave_click und weave_type lokalisieren und interagieren automatisch mit Elementen in einem Schritt, basierend auf deren Absicht oder Beschriftung.
Lokal & Sicher: Keine Cloud-Abhängigkeiten. Integrierte Ratenbegrenzung und optionaler Sicherheitsmodus (Safe Mode).
Screenshot-Unterstützung: Nutzen Sie optional weave_screenshot, um aktuelle Tabs zu erfassen, oder weave_peek für gezielte visuelle Analyse spezifischer Elemente/Canvas.

🚀 Schnellstart (MCP-Integration)

Der einfachste Weg, WeaveTab zu nutzen, ist via npx. Fügen Sie Folgendes zu Ihrer MCP-Client-Konfiguration hinzu (z. B. Cursor, OpenCode, Claude Desktop).

Cursor / OpenCode

Fügen Sie dies zu den MCP-Konfigurationseinstellungen Ihrer IDE hinzu:

{
  "mcpServers": {
    "weavetab": {
      "command": "npx",
      "args": ["-y", "@fy2ne/weavetab@latest"]
    }
  }
}

Claude Desktop

Bearbeiten Sie Ihre claude_desktop_config.json:

{
  "mcpServers": {
    "weavetab": {
      "command": "npx",
      "args": ["-y", "@fy2ne/weavetab@latest"]
    }
  }
}

🛠️ Tool-Arsenal

WeaveTab stellt eine umfangreiche Palette spezialisierter Tools für Ihre KI bereit:

weave_read: Liest die Seite und gibt eine semantische Aktionskarte zurück.
weave_click: Klickt auf Elemente anhand von Beschriftung, Absicht oder ID.
weave_type: Gibt Text sicher in Formulare ein.
weave_navigate: Navigiert zu einer Ziel-URL.
weave_scroll: Scrollt nach oben, unten, zum Anfang oder Ende.
weave_wait: Wartet auf bestimmte Zustände (Navigation, Element, DOM-Stabilität).
weave_tabs: Listet offene Tabs auf oder wechselt zwischen ihnen.
weave_extract: Extrahiert sichtbaren Inhalt als Text oder JSON.
weave_screenshot: Erstellt ein PNG der aktuellen Ansicht.
weave_peek: Gezielte visuelle Analyse über spezifische Koordinaten.
weave_key: Drückt physische Tasten und Modifikatoren.
weave_find: Findet Elemente semantisch, ohne die gesamte Seite zu extrahieren.

🛡️ Sicherheit & Konfiguration

WeaveTab respektiert Ihr System. Es verweigert aktiv die Ausführung als root/sudo.

Beim ersten Start generiert WeaveTab eine Konfigurationsdatei unter ~/.weavetab/config.json:

{
  "safeMode": false,
  "allow": [],
  "rateLimitMs": 1000,
  "preferredBrowser": "google-chrome",
  "persistentProfile": false,
  "screenshot": true,
  "peek": true
}

Sicherheitsfunktionen

Speicher-Hard-Block: Deaktiviert Skripte, die in bestimmten Umgebungen auf Cookies/localStorage zugreifen.
Root-Erkennung: Beendet den Prozess, wenn er mit Root-Rechten ausgeführt wird.
Domain-Allowlist: Verhindert, dass Ihr Agent nicht vertrauenswürdige Seiten besucht, wenn der safeMode aktiv ist.
Audit-Logging: Jede von der KI durchgeführte Aktion wird zur Überprüfung lokal unter ~/.weavetab/audit.log protokolliert.

🤝 Mitwirken

Beiträge sind willkommen!

git clone https://github.com/fy2ne/WeaveTab.git
cd WeaveTab
npm install
npm run build

📄 Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert - siehe die LICENSE Datei für Details.

WeaveTab-MCP