parallel-browser-mcp

parallel-browser-mcp es un servidor MCP para la automatización de navegadores en paralelo. Expone un modelo de sesión numérica sobre MCP para que un cliente pueda crear y controlar múltiples sesiones de navegador al mismo tiempo a través de múltiples proveedores de navegador.

Proveedores compatibles:

• playwright para Chromium local

• browserbase a través de @browserbasehq/sdk

• anchor a través de anchorbrowser

• cloudflare a través de Cloudflare Browser Run

Cada sesión de navegador obtiene un ID numérico como 1, 2, 3, y cada herramienta browser_* acepta un sessionId.

Características

• Múltiples sesiones de navegador concurrentes en memoria

• Abstracción de proveedor compartida entre Browserbase, Anchor Browser, Cloudflare Browser Run y Playwright local

• Herramientas de sesión MCP:

  • start_session

  • close_session

  • close_all_sessions

  • get_sessions

• Herramientas de navegador:

  • browser_navigate

  • browser_go_back

  • browser_click

  • browser_fill

  • browser_fill_form

  • browser_screenshot

  • browser_snapshot

  • browser_hover

  • browser_drag

  • browser_select_option

  • browser_generate_locator

  • browser_get_page_structure

  • browser_evaluate

  • browser_keyboard_press

  • browser_keyboard_type

  • browser_mouse_move

  • browser_mouse_click_xy

  • browser_mouse_drag

  • browser_upload_file

  • browser_wait_for_selector

  • browser_wait_for_timeout

Inicio rápido

corepack pnpm install
corepack pnpm build

Ejecutar localmente sobre stdio:

node dist/index.js

Ejecutarlo como una CLI de paquete npm:

npx parallel-browser-mcp@latest

Configuración

Los ajustes específicos del proveedor se configuran a nivel de configuración del servidor MCP, no por llamada de herramienta.

El servidor lee la configuración en este orden:

1. BROWSER_MCP_CONFIG

2. BROWSER_MCP_CONFIG_PATH

3. valores predeterminados de entorno directos

4. valores predeterminados integrados

Forma de configuración recomendada:

{
  "defaultProvider": "playwright",
  "providers": {
    "browserbase": {
      "projectId": "proj_123",
      "keepAlive": true
    },
    "anchor": {
      "recording": false
    },
    "playwright": {
      "launchOptions": {
        "headless": true
      }
    }
  }
}

Credenciales requeridas por proveedor:

• playwright: ninguna

• browserbase: BROWSERBASE_API_KEY, además de un projectId en la configuración o BROWSERBASE_PROJECT_ID

• anchor: ANCHOR_API_KEY

• cloudflare: CLOUDFLARE_API_TOKEN, CLOUDFLARE_ACCOUNT_ID

Valores predeterminados de entorno opcionales:

• BROWSERBASE_PROJECT_ID

• BROWSERBASE_KEEP_ALIVE

• BROWSERBASE_CONTEXT_ID

• BROWSERBASE_PERSIST

• PLAYWRIGHT_STORAGE_STATE_PATH

• PLAYWRIGHT_EXECUTABLE_PATH

• PLAYWRIGHT_CHANNEL

Instalación

Utilice la configuración estándar a continuación en cualquier cliente MCP que admita stdio:

{
  "mcpServers": {
    "parallel-browser-mcp": {
      "command": "npx",
      "args": ["parallel-browser-mcp@latest"],
      "env": {
        "BROWSER_MCP_CONFIG": "{\"defaultProvider\":\"playwright\",\"providers\":{\"playwright\":{\"launchOptions\":{\"headless\":true}}}}",
        "BROWSERBASE_API_KEY": "your_browserbase_key",
        "ANCHOR_API_KEY": "your_anchor_key"
      }
    }
  }
}

Utilice la CLI de Claude Code para añadir el servidor:

claude mcp add parallel-browser-mcp npx parallel-browser-mcp@latest

Si necesita configuración del proveedor, añada las variables de entorno en su configuración de Claude MCP utilizando la configuración estándar anterior.

Siga el flujo de instalación de MCP de Claude Desktop y utilice la configuración estándar anterior en el archivo de configuración local de MCP.

Utilice la CLI de Codex:

codex mcp add parallel-browser-mcp npx "parallel-browser-mcp@latest"

O añada esto a ~/.codex/config.toml:

[mcp_servers.parallel-browser-mcp]
command = "npx"
args = ["parallel-browser-mcp@latest"]

Utilice el flujo interactivo de la CLI de Copilot:

/mcp add

O añada esto a ~/.copilot/mcp-config.json:

{
  "mcpServers": {
    "parallel-browser-mcp": {
      "type": "local",
      "command": "npx",
      "tools": ["*"],
      "args": ["parallel-browser-mcp@latest"],
      "env": {
        "BROWSER_MCP_CONFIG": "{\"defaultProvider\":\"playwright\",\"providers\":{\"playwright\":{\"launchOptions\":{\"headless\":true}}}}",
        "BROWSERBASE_API_KEY": "your_browserbase_key",
        "ANCHOR_API_KEY": "your_anchor_key"
      }
    }
  }
}

Vaya a Cursor Settings -> MCP -> Add new MCP Server, luego utilice:

• command: npx

• args: parallel-browser-mcp@latest

O pegue la configuración estándar anterior en el editor de configuración de MCP.

Añada el servidor a .gemini/settings.json:

{
  "mcpServers": {
    "parallel-browser-mcp": {
      "command": "npx",
      "args": ["parallel-browser-mcp@latest"],
      "env": {
        "BROWSER_MCP_CONFIG": "{\"defaultProvider\":\"playwright\",\"providers\":{\"playwright\":{\"launchOptions\":{\"headless\":true}}}}",
        "BROWSERBASE_API_KEY": "your_browserbase_key",
        "ANCHOR_API_KEY": "your_anchor_key"
      }
    }
  }
}

Utilice el flujo de instalación de MCP en VS Code con la configuración estándar anterior, o instálelo con la CLI de VS Code:

code --add-mcp '{"name":"parallel-browser-mcp","command":"npx","args":["parallel-browser-mcp@latest"]}'

Ejemplo de flujo

1. Llame a start_session con { "provider": "playwright" }

2. Lea el id de sesión devuelto

3. Llame a browser_navigate con { "sessionId": 1, "url": "https://example.com" }

4. Llame a cualquier herramienta browser_* adicional con el mismo sessionId

5. Llame a close_session cuando haya terminado

Desarrollo

corepack pnpm install
corepack pnpm typecheck
corepack pnpm test
corepack pnpm test:coverage
corepack pnpm build
corepack pnpm smoke:local

Publicación

Este repositorio está configurado para publicarse como un paquete npm:

• el punto de entrada de la CLI es parallel-browser-mcp

• las compilaciones de producción excluyen pruebas y scripts de humo

• el paquete publicado solo incluye dist, README.md y .env.example

Antes de publicar:

corepack pnpm typecheck
corepack pnpm test
corepack pnpm build
npm pack --dry-run

Publicación con GitHub Actions:

• .github/workflows/publish.yml publica en npm al publicar una versión de GitHub o mediante despacho manual

• establezca el secreto de repositorio NPM_TOKEN antes de usar el flujo de trabajo de publicación

Ejemplos

• examples/local contiene un paquete npm independiente que se conecta a parallel-browser-mcp con `@