Skip to main content
Glama

browser-tools-mcp

Persistente, sichtbare Chromium-Browsersteuerung für OpenCode/Claude Code, im Stil des Browser-Tools von Claude Code. Gebaut am 2026-08-05, weil OpenCode kein natives Browser-Tool hatte und custom-scraper (reines HTTP) keine JS-lastigen oder login-geschützten Seiten lesen kann.

Architektur

Der MCP-Serverprozess ist der Singleton-Browser-Manager. Da OpenCode den Stdio-Server für die gesamte CLI-Sitzung am Leben hält, überlebt der Browser über Agentenwechsel hinweg. Wenn der Browser abstürzt oder das Fenster geschlossen wird, startet der nächste Tool-Aufruf ihn transparent neu (server/browser.js).

Startkonfiguration: headless: false, slowMo: 100, Viewport 1280x800, Desktop-Chrome-UA, --disable-blink-features=AutomationControlled.

Related MCP server: chrome-mcp

Dateien

  • server/server.js — MCP-Einstiegspunkt, registriert die fünf Tools + Schemas.

  • server/browser.js — Singleton-Browser/Kontext/Seiten-Manager + Neustartlogik.

  • server/tools.js — die Operationen (interaktiver Baum, Targeting, Hervorhebung, Screenshots).

  • server/_self_verify.js — eigenständiges Szenario-Test: npm run verify.

  • shots/ — Screenshots von browser_inspect.

  • USAGE.md — agentenorientierte Regeln (in OpenCode instructions eingebunden).

Tools

Tool

Zweck

browser_navigate(url)

Lädt eine URL; gibt finale URL + Titel zurück.

browser_inspect()

Screenshot + interaktiver Elementbaum mit numerischen Zielen.

browser_click(target)

Klicken per Inspektionsnummer, CSS-Selektor oder sichtbarem Text.

browser_fill(target, value)

Eingabe in ein Feld per Nummer/Selektor/Text.

browser_request_human(message)

Pausiert den Ablauf und zeigt dem Menschen eine Frage an.

Das Element-Targeting entspricht der Claude-Code-Konvention: browser_inspect weist jedem interaktiven Element ein numerisches target zu, das im DOM als data-bt-target markiert wird, sodass spätere Aktionen dasselbe Element auflösen (sichtbar gefilterte Indizes würden gegenüber ungefiltertem .nth() auf Seiten mit versteckten Eingaben abweichen). Elemente werden vor dem Klicken kurz hervorgehoben, damit der Benutzer die Aktion sieht.

Verifizierung

npm run verify        # navigate -> inspect -> click -> fill -> crash-recovery

Verifiziert am 2026-08-05: example.com navigieren/inspizieren/klicken, Google-Ausfüllen per Ziel und Neustart-nach-Kill bestehen alle; alle fünf Tools wurden registriert und antworteten über das echte MCP-Stdio-Protokoll.

Betriebshinweise

  • Sichtbar bedeutet ein Desktop. Das Chromium-Fenster benötigt eine interaktive Sitzung zum Starten; auf einer headless/getrennten Maschine schlägt der Start fehl — melde das, anstatt es vorzutäuschen.

  • Isolierter Browser. Dies ist NICHT Luigis angemeldeter Chrome (das ist chrome-bridge). Keine angemeldeten Sitzungen, keine Erweiterungen, voller Schreibzugriff.

  • Menschengesteuert. Keine Logins/Bestellungen/Sendungen ohne ausdrückliche Anweisung; browser_request_human bedeutet STOPP, bis der Mensch antwortet.

  • Registriert in ~/.config/opencode/opencode.jsonc als MCP-Server browser-tools; Nutzungsregeln über USAGE.md in instructions eingebunden.

A
license - permissive license
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • F
    license
    -
    quality
    B
    maintenance
    Enables Claude Code to control a real browser using AI for web scraping, competitive intelligence, and UX auditing through the MCP protocol.
  • A
    license
    B
    quality
    A
    maintenance
    Enables controlling a real Chrome browser from MCP hosts like Claude, with extension-based or CDP fallback, supporting tabs, navigation, interaction, and page reading tools.
    33
    265
    5
    MIT
  • A
    license
    -
    quality
    B
    maintenance
    Enables Codex to control a visible Chromium browser via MCP tools for navigation, page inspection, and interaction, while keeping sensitive steps like login and captcha under the user's control.
    3
    1
    MIT

View all related MCP servers

Related MCP Connectors

  • Hosted real Google Chrome MCP with per-user persistent state. Navigate, click, type, screenshot.

  • Browser MCP for logged-in tasks. Uses your Chrome — credentials stay local. Zero-token replay.

  • Live browser debugging for AI assistants — DOM, console, network via MCP.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/luigimasango-dev/browser-tools-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server