BROWSER_MCP_CONFIG — Inline JSON configuration for providers and defaults. See README for shape.
BROWSER_MCP_CONFIG_PATH — Path to a JSON file with provider configuration.
BROWSERBASE_API_KEY — Browserbase API key (required when using the browserbase provider).
BROWSERBASE_PROJECT_ID — Browserbase project ID (required when using the browserbase provider, unless set in config).
ANCHOR_API_KEY — Anchor Browser API key (required when using the anchor provider).
CLOUDFLARE_API_TOKEN — Cloudflare API token (required when using the cloudflare provider).
CLOUDFLARE_ACCOUNT_ID — Cloudflare account ID (required when using the cloudflare provider).
PLAYWRIGHT_USE_CLOAKBROWSER — Set to 'true' to launch the local Playwright provider via CloakBrowser (https://cloakbrowser.dev/) stealth Chromium. Requires installing the optional 'cloakbrowser' npm package.
Claude Code에는 로컬 명령용 설치 링크가 없습니다. 아래 명령을 복사해 터미널에서 실행합니다.
parallel-browser-mcp is an MCP server for parallel browser automation. It exposes a numeric session model over MCP so one client can create and control multiple browser sessions at the same time across multiple browser providers.
Supported providers:
MCP server for parallel browser automation across multiple providers.
The playwright provider can optionally launch CloakBrowser instead of vanilla Chromium for sessions that need to bypass bot detection. Enable it per-config or via env:
cloakbrowser is an optional peer — install it only when you need stealth:
npm install cloakbrowser
The CloakBrowser binary (~200MB stealth Chromium) is downloaded automatically on the first session launch. Existing launchOptions / contextOptions continue to apply, and the rest of the provider behaves identically to standard Playwright.
Required credentials by provider:
playwright: none
browserbase: BROWSERBASE_API_KEY, plus a projectId in config or BROWSERBASE_PROJECT_ID
.github/workflows/publish.yml publishes to npm on GitHub release publication or manual dispatch
set the NPM_TOKEN repository secret before using the publish workflow
Examples
examples/local contains a standalone npm package that connects to parallel-browser-mcp with @langchain/mcp-adapters and runs a LangChain agent against the local Playwright provider.
examples/browserbase contains a standalone npm package that connects LangChain to the published MCP server with Browserbase config and prompts the agent to use browser_screenshot.
examples/anchor contains a standalone npm package that connects LangChain to the published MCP server with Anchor config and prompts the agent to use browser_snapshot.
examples/cloudflare contains a standalone npm package that connects LangChain to the published MCP server with Cloudflare Browser Run config and prompts the agent to use browser_snapshot.
The root .npmignore excludes the full examples directory from npm publishing.
Testing
The repo includes:
unit coverage for config loading, providers, registry behavior, session tools, and representative browser tools
a local Playwright smoke script in src/smoke/localSmoke.ts
Notes
start_session is intentionally small. Provider-specific behavior belongs in MCP configuration, not tool inputs.
The server logs to stderr so stdout stays clean for MCP JSON-RPC traffic.
Browserbase and Anchor Browser are normalized to Playwright page operations after connection, so the browser tools stay provider-agnostic.