Agentic Tab Organizer MCP

Verbinden Sie jeden MCP-kompatiblen KI-Agenten mit Live-Tabs in einem Chromium-basierten Browser. Der Agent kann Tabs auflisten, ausgewählte Seiteninhalte lesen, einen Organisationsplan in der Vorschau anzeigen und behaltene Tabs in einem einzigen deduplizierten Fenster zusammenführen.

Der Organizer enthält kein KI-Modell und benötigt keinen KI-API-Schlüssel. Ihr MCP-Client verwendet seine vorhandene Modellauthentifizierung. Stdio- und eigenständige HTTP-Verbindungen verwenden ein lokales Pairing-Token, das von der Erweiterung angezeigt wird; dieses Token verlässt niemals Ihren Rechner.

Funktionen

• Tabs aus jedem normalen Browserfenster mit Titeln, URLs, Gruppen und Tab-Status auflisten

• Begrenzten lesbaren Text aus ausgewählten HTTP- und HTTPS-Tabs extrahieren

• Tabs nach exakter Domain oder expliziten Tab-IDs schließen, mit optionalem Subdomain-Abgleich

• Exakte normalisierte URLs deduplizieren und dabei die bevorzugte Kopie beibehalten

• Angeheftete Tabs während der Organisation und bei beliebigen Schließvorgängen beibehalten, sofern nicht ausdrücklich erlaubt

• Geordnete Kategorien in der Vorschau anzeigen und validieren, bevor der Browser geändert wird

• Ein Zielfenster mit sichtbaren Tab-Gruppen oder einen flachen, von links nach rechts angeordneten Tab-Streifen erstellen

• Behaltene Tabs sortieren und verifizieren, bevor Duplikate geschlossen werden

• Über Standard-MCP-stdio oder lokales Streamable HTTP verbinden

Related MCP server: ChromeWire MCP

Voraussetzungen

• Brave Browser, Google Chrome oder ein anderer kompatibler Chromium-Browser

• Node.js 20 oder neuer

• Ein MCP-kompatibler Agent wie OpenCode, Claude Desktop, Cursor oder ein anderer MCP-Client

Entwicklung und Verifikation im echten Browser erfolgen hauptsächlich mit Brave. Chrome und verwandte Chromium-Browser verwenden dieselben Erweiterungs-APIs und sollten funktionieren, erhalten derzeit jedoch nicht dieselbe End-to-End-Abdeckung.

Erstellen

npx pnpm@11.24.0 install
npx pnpm@11.24.0 run build

Öffnen Sie brave://extensions in Brave oder chrome://extensions in Chrome, aktivieren Sie den Entwicklermodus, wählen Sie Entpackte Erweiterung laden und wählen Sie anschließend das dist-Verzeichnis dieses Repositorys aus.

Öffnen Sie das Popup der Erweiterung und kopieren Sie dessen lokales Pairing-Token.

Einen Agenten verbinden

Stdio

Stdio ist die einfachste Option. Konfigurieren Sie Ihren MCP-Client mit dem absoluten Pfad zu dist-node/mcp-stdio.cjs:

{
  "mcpServers": {
    "agentic-tabs": {
      "command": "/absolute/path/to/agentic-tab-organizer/dist-node/mcp-stdio.cjs",
      "env": {
        "AGENTIC_TABS_BRIDGE_TOKEN": "TOKEN_FROM_EXTENSION_POPUP"
      }
    }
  }
}

Der Agentprozess öffnet eine nur auf localhost verfügbare Browser-Brücke. Die Erweiterung verbindet sich automatisch neu.

Streamable HTTP

Starten Sie den persistenten lokalen Server:

AGENTIC_TABS_BRIDGE_TOKEN="TOKEN_FROM_EXTENSION_POPUP" npx pnpm@11.24.0 run mcp:http

Konfigurieren Sie den MCP-Client für die Verwendung von:

http://127.0.0.1:32145/mcp

Führen Sie Stdio- und HTTP-Modus nicht gleichzeitig aus, da beide denselben lokalen Port der Browser-Brücke verwenden.

Native Messaging

Native Messaging ist auf macOS und Linux optional. Der Installer registriert denselben Host für Google Chrome, Brave und Chromium:

npx pnpm@11.24.0 run install:host

Nach dem Neuladen der Erweiterung startet der Browser den lokalen HTTP-MCP-Host automatisch. Verbinden Sie einen HTTP-MCP-Client mit http://127.0.0.1:32145/mcp.

Agenten-Workflow

Der MCP stellt fünf Tools bereit:

Beispielanfrage:

Untersuchen Sie alle Browser-Tabs. Fassen Sie mehrdeutige Seiten bei Bedarf zusammen, gruppieren Sie sie in Arbeit, Lesen, Soziales, Entwicklung und Sonstiges und zeigen Sie dann den Plan in der Vorschau an. Konsolidieren Sie sie nach Genehmigung in einem deduplizierten Fenster.

Schließen Sie alle offenen Tabs von amazon.nl.

browser_plan_organization akzeptiert createGroups, das standardmäßig true ist. Setzen Sie es auf false, um die Kategorienreihenfolge nur für die Platzierung von links nach rechts zu verwenden: Angeheftete Tabs bleiben zuerst, gefolgt von jeder Kategorie in der angegebenen Reihenfolge, ohne sichtbare Tab-Gruppen im Zielfenster.

Konsolidieren Sie alle Fenster in einem deduplizierten Fenster. Erstellen Sie keine Tab-Gruppen; ordnen Sie die Kategorien stattdessen von links nach rechts an.

Sicherheit und Datenschutz

• Planung verändert den Browser nicht.

• Das Anwenden bricht ab, wenn sich Tabs, URLs, Fenster, Anheftstatus, Reihenfolge oder Gruppen nach der Planung geändert haben.

• Duplikat-Tabs werden erst geschlossen, nachdem die behaltenen Tabs im Zielfenster verifiziert wurden.

• browser_close_tabs unterstützt eine exakte Domain wie amazon.nl oder explizite IDs, die von browser_list_tabs zurückgegeben werden; ein führendes www wird normalisiert und Subdomains erfordern eine ausdrückliche Zustimmung.

• Bevor etwas geschlossen wird, verifiziert die Erweiterung, dass jeder ausgewählte Tab noch die vom MCP-Server beobachtete URL aufweist. Wenn ein Tab in der Zwischenzeit navigiert wurde, wird der gesamte Schließvorgang abgebrochen.

• Angeheftete Tabs werden standardmäßig übersprungen und erscheinen in skippedTabs; zum Schließen ist allowPinned: true erforderlich.

• Organisations- und beliebige Schließvorgänge teilen sich eine Mutationssperre, die verhindert, dass sie den Browser gleichzeitig verändern.

• Der Inkognito-Zugriff ist deaktiviert.

• Die lokale WebSocket-Brücke bindet nur an 127.0.0.1 und akzeptiert die feste Origin der Erweiterung.

• Die Erweiterung und der lokale MCP-Prozess authentifizieren sich gegenseitig per Challenge-Response-HMAC; das Pairing-Token wird niemals übertragen.

• Seiteninhalte werden nur zurückgegeben, wenn ein Agent browser_get_tab_content aufruft.

• Geschützte Browserseiten wie brave:// und chrome:// können nicht gelesen, aber weiterhin aufgelistet und verschoben werden.

• Inhalte, die an einen Agenten zurückgegeben werden, können an den konfigurierten Modellanbieter dieses Agenten gesendet werden.

Entwicklung

npx pnpm@11.24.0 run typecheck
npx pnpm@11.24.0 run test:unit
npx pnpm@11.24.0 run test:integration
npx pnpm@11.24.0 run test:e2e
npx pnpm@11.24.0 run build

Die End-to-End-Suite startet Brave mit einem temporären Profil und berührt niemals das normale Browserprofil des Benutzers. Brave ist der primär verifizierte Browser; die Chrome-Kompatibilität ergibt sich aus den gemeinsamen Chromium-Erweiterungs-APIs und browserneutralen Integrationspfaden.