Skip to main content
Glama
xlreon
by xlreon

Chrome Actuator

Inoffizieller Begleiter: Steuern Sie das bereits geöffnete Chrome-Fenster über einen Agenten (getestet mit Grok Build). Neue Arbeiten landen in einer pinken Actuator-Tabgruppe in der aktuellen Sitzung, nicht in einem neuen Chrome-Fenster.

tabs_create → snapshot → press @e12 / fill @e5 "text" → settle

Version 1 ist ein Aktuator, kein Side-Panel-Chatbot. Der Agent bleibt im Terminal. Die Erweiterung sieht die Seite, weist @eN-Referenzen zu und klickt/tippt. Ihre Cookies und Anmeldungen bleiben in Chrome.

Nicht verbunden mit, unterstützt oder gesponsert von xAI. „Grok“ und „Grok Build“ sind Marken von xAI, die hier nur zur Beschreibung der Kompatibilität verwendet werden. Siehe HINWEIS.

Status

Die Phasen 0–3 sind abgeschlossen. pnpm gauntlet deckt Unit-Tests, den Inhaltsskript-Aktuator und einen Live-Chromium-Tab ab, der über native Nachrichtenübermittlung gesteuert wird.

Phase

Was

Status

0

Workspace, stabile Erweiterungs-ID, Seitenleiste

erledigt

1

Heartbeat über native Nachrichten

erledigt

2

snapshot / press / fill auf einem echten Tab

erledigt

3

Agent-Plugin + /chrome + Fähigkeit

erledigt

Related MCP server: login-mcp

Erweiterung laden

cd /path/to/chrome-actuator
pnpm install
pnpm --filter @chrome-actuator/extension build
  1. Öffnen Sie chrome://extensions

  2. Aktivieren Sie den Entwicklermodus

  3. Entpackte Erweiterung laden → packages/extension/dist

  4. Heften Sie die Erweiterung an und klicken Sie darauf (oder Cmd+Shift+G)

Registrieren Sie dann den nativen Host (einmalig) und beenden Sie Chrome vollständig:

node packages/host/dist/install.js

--trust bei der Plugin-Installation ermöglicht es dem Agenten, dieses Chrome-Profil zu bedienen. Tun Sie dies nur, wenn Sie dem Agenten vertrauen.

grok plugin install ./packages/plugin --trust

Die Seitenleiste sollte connected anzeigen, sobald der MCP-Host läuft.

pnpm gauntlet   # unit + L3 + live native-messaging L4

Stabile entpackte ID (aus dem festgeschriebenen Manifest-key): lgkcgenkjaalkfnpmglgpfclkaokblfj

Entscheidungen, die wir nicht wieder aufgreifen werden

  • Gehirn im Agenten, Körper in Chrome. Keine Erweiterungsinterne LLM-Schleife in v1.

  • Native Nachrichten, nicht WebSocket, nicht Playwright, nicht Agent-Device-Das-Binärprogramm.

  • Agent-Device Vertrag nur (snapshot / press / fill).

  • Kein chrome.debugger in v1 (keine gelbe Infoleiste).

  • Unabhängige Implementierung. Kopieren Sie keine Marke, Marken oder rückentwickelten Interna eines anderen Anbieters in diesen Baum.

Layout

packages/shared      protocol, snapshot grammar, target parser
packages/extension   MV3 side panel + service worker
packages/host        MCP + native host
packages/plugin      Grok Build plugin (compatibility layer)

Tests

pnpm --filter @chrome-actuator/shared test

Lizenz

MIT. Siehe LIZENZ und HINWEIS.

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    A
    maintenance
    Enables MCP agents to drive an already signed-in Chrome or Edge browser through a local extension bridge, controlling existing tabs and opening task-related HTTP(S) tabs without remote debugging or profile copying.
    23
    MIT
  • A
    license
    A
    quality
    B
    maintenance
    Enables agents to reuse a human-completed Chrome login session to open confirmed origins, read visible page text, and perform single click, fill, or key press actions without ever handling passwords or exposing cookies.
    6
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables MCP agents to drive the user's already-open Chrome profile through a Manifest V3 extension and loopback bridge, listing and controlling existing tabs, capturing screenshots, and sending clicks, typing, drags and key holds via an independent on-page cursor without moving the system mouse. It also supports form filling, console and network inspection, read-only or confirmed JavaScript execution, file and PDF downloads, and game-style screenshot/action loops with snapshot recovery and an emergency stop.
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables reading and acting on pages in an existing Chrome profile through a local extension and Native Messaging host, without moving login data. It exposes 12 tools to list and claim tabs, snapshot visible text and targets, and click, fill, select, or scroll using snapshot IDs.
    PolyForm Noncommercial 1.0.0