Inicio Explorar Axuda
Rexistro Iniciar sesión
haiany
/
deepseek-harness
réplica de https://github.com/deepseek-ai/deepseek-harness.git
1
0
Fork 0
Ficheiros Incidencias 0 Wiki
Rama: master
Ramas Etiquetas
deepseek-harnes...
/
packages
/
experimental
/
browser-use-chrome-devtools-mcp
/
README.md

README.md 6.2 KB
Permalink Histórico Raw

description: "Operate Chromium through Chrome DevTools MCP with separate browser state for each live Session."

kind: "package-reference"

@deepseek-ai/dsh-experimental-browser-use-chrome-devtools-mcp

English | 中文

Summary

Use Chrome DevTools MCP to inspect pages and operate Chromium through its upstream tools. The provider initializes a Session's MCP connection before creation or resume completes and retains it across turns. Launch a separate browser or attach one Session to an existing browser with its current tabs and login state. This published experimental package activates only when explicitly mounted.

Table of Contents

Use this package

Mount both entries before creating or resuming a Session, in a profile composition that supplies Agents, tools, and system prompts. Loading or reloading this provider does not adopt Sessions that are already active. Browser installation follows the upstream runtime; select an existing Chromium installation with executablePath.

- name: '@deepseek-ai/dsh-browser-use'
- name: '@deepseek-ai/dsh-experimental-browser-use-chrome-devtools-mcp'
  config:
    mode: launch
    headless: true

Use mode: attach and set endpoint to an HTTP(S) debugging URL or WS(S) browser endpoint to operate an existing browser. The new live Session claims the attachment during initialization and retains it until unloading. If the attachment is busy, that activation continues without this browser and does not retry on later turns. After release, a newly created or resumed activation can acquire it. Direct calls from another Session fail. Cleanup disconnects and leaves the external browser and its pages running.

Field Default Meaning
mode required launch or attach, fixed for this provider activation
headless true Launch without a visible window
executablePath upstream discovery Chromium executable for launch
endpoint required for attach Existing browser debugging endpoint
toolCallTimeoutMs MCP client default Per-call timeout in milliseconds

The configuration catalog lists accepted fields. The profile or preset selects the browser mode.

When configuring the system prompt's toolOrder for the whole process, leave browser tools under <unlisted-tools>. Explicitly listing browser tool names can make prompt assembly fail for Sessions without a browser connection.

Understand the implementation

Implementation internals — click to expand The provider resolves its pinned npm entry and starts it under the current Node executable. A temporary protocol probe may precede the serving process. The [shared runtime](../browser-use-runtime/README.md) owns awaited Agent initialization, per-Session serialization, and cleanup; the [MCP client](../../mcp/mcp-client/README.md) owns transport, discovery, and result projection. No runtime invariant companion is published because the provider maintains no independent connection observation. Browser state survives turns while its live Session remains attached. Disposal waits for server shutdown before releasing resources. Resume after reload starts fresh browser runtime state; stored conversation history does not restore cookies or pages.

Further Exploration

Model Experience

Browser tools and screenshots

What the model sees

Tools retain upstream descriptions and JSON schemas under mcp__chrome-devtools-mcp__<tool> names. Text and screenshots use the normal tool-result pipeline and Session log. Screenshots require an attachment store and an image-capable model route; other routes receive the MCP image diagnostic. The MCP client also exposes resource helpers and attributed server instructions. Browser instructions are shown only after this Session owns a connection; targeted resource requests enforce the same ownership.

Token effect

The catalog, resource helpers, and server instructions add tool definitions and prompt text. Calls add arguments, text, and admitted images to Session history. Inline image bytes stay outside model-visible history.

KV Cache effect

An unchanged catalog preserves its tool-definition prefix. Results append to history; provider or catalog changes can reduce prefix reuse.

Known Limitations and Deferred Work

The integration retains the pinned server's browser and tool restrictions.

  • Chromium only; Firefox and WebKit are not selectable.
  • Startup failure or cancellation rejects Session creation or resume and triggers client cleanup. A disconnected client is not retried; after fixing the cause, create a new Session or unload and resume the existing one.
  • Attachment exclusivity is local to this provider instance. Other processes and browser users can still modify the same pages.
  • The shared resource-server inventory can show inherited server names; it does not grant access to another Session's browser.
  • Cancellation does not undo navigation, clicks, or other actions already delivered to the browser.
  • Tool schemas follow the pinned experimental dependency and carry no DSH stability promise.
  • Usage statistics are disabled. Other features, including performance tools, retain their upstream behavior.

Dev Note

Working context for maintainers — click to expand None.