Skip to main content
Glama
apexradius

apex-browser-mcp

by apexradius

apex-browser-mcp

Local multi-session browser MCP for real Chrome, Chromium, WebKit, and real Safari, plus attach to an already-running Chrome session without moving the work into a cloud browser.

Release posture: npm package @apexradius/browser-mcp, version 1.0.0 from package.json.

Choose your path

You are...

Start here

Then

Running the daemon or stdio server

docs/start-here.md

Quick start below

Auditing browser routing or attach behavior

docs/architecture.md

src/manager.js

Reviewing the MCP tool surface

src/server.js

src/index.js

Related MCP server: paparazzi

Architecture

flowchart TD
  U[AI operator] --> C[MCP client]
  C --> T[stdio or HTTP transport]
  T --> S[MCP server]
  S --> M[BrowserManager]
  M --> P[SessionPool]
  M --> F[SafariLane]
  P --> B[Chrome Chromium WebKit sessions]
  P --> D[Attached Chrome via CDP]
  F --> R[Real Safari.app session]

Request flow

flowchart TD
  A[Operator opens or attaches a browser session] --> B[Selected MCP tool]
  B --> C{New session or attach?}
  C -- new --> D[BrowserManager creates session]
  C -- attach --> E[Connect to CDP endpoint]
  D --> F[Session stored in pool]
  E --> F
  F --> G[Subsequent navigate snapshot click type evaluate tools]
  G --> H[Return text or screenshot path to MCP client]

Quick start

  1. Install dependencies and browser engines.

npm install
npx playwright install chromium webkit
  1. Start the shared HTTP daemon.

APEX_BROWSER_TRANSPORT=http node src/index.js
  1. Register it in your MCP client.

{
  "mcpServers": {
    "apex-browser": {
      "type": "http",
      "url": "http://127.0.0.1:3010/mcp"
    }
  }
}

Available tools

Tool group

Tools

Purpose

Session lifecycle

browser_new_session, browser_attach, browser_list_sessions, browser_close_session

Open, adopt, inspect, and close sessions

Navigation and state

browser_navigate, browser_snapshot

Load pages and capture indexed interactive refs

Interaction

browser_click, browser_type, browser_evaluate

Drive page interactions and execute page JS

Artifacts

browser_screenshot

Save a PNG and return its path

Runtime proof

Claim

Proof

Package entry point is stable

"apex-browser-mcp": "src/index.js" in package.json

HTTP and stdio transports are both first-class

Transport selection in src/index.js

Session routing is engine-aware

BrowserManager in src/manager.js

Tool registration is centralized

buildServer() in src/server.js

Repo map

Path

Purpose

src/index.js

Process entry point, transport selection, HTTP daemon

src/server.js

MCP tool registration and request handlers

src/manager.js

Unified routing across SessionPool and SafariLane

src/pool.js

Multi-session Playwright and CDP attach backend

src/safari.js

Real Safari.app lane

docs/start-here.md

Setup, env, validation, common failures

docs/architecture.md

Component map and runtime lifecycle

Validation

Check

Command

Core regression suite

npm test

Attached-Chrome concurrency

node test/attach-concurrent.js

README/docs links stay local

rg '\\]\\(([^)]+\\.md)\\)' README.md docs/

License

MIT

Install Server
A
license - permissive license
B
quality
B
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

  • A
    license
    -
    quality
    D
    maintenance
    A standalone MCP server for Chrome automation with multi-session support, enabling browser control and page interaction through MCP clients.
    40
    1
    MIT
  • A
    license
    -
    quality
    D
    maintenance
    MCP server that connects to your browser to capture screenshots, inspect console logs, network requests, and more via Chrome DevTools Protocol.
    4
    2
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    MCP server for controlling Chromium/Chrome via Chrome DevTools Protocol. Supports cross-platform automation, auto-launch, and automatic reconnection.
    25
    1
    MIT
  • A
    license
    -
    quality
    B
    maintenance
    An MCP server for QA and test automation that provides runtime switching between multiple browser profiles (Chromium, Firefox, WebKit) without restart, enabling cross-browser regression testing, multi-account testing, localization QA, and more.
    9
    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.

  • Headless-browser-as-JSON with memorymarket cache economics. Real Chromium, crypto settlement.

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/apexradius/browser-mcp'

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