browser-devtools-mcp

Playwright browser & Node.js MCP. ARIA refs, screenshots, ref-based interactions.

HTTP v0.4.0

GitHub

Connection Configuration

Add this to your AI agent's MCP config file to connect.

Run in your terminal:

claude mcp add io.github.serkan-ozal--browser-devtools-mcp --transport http https://{your_mcp_server_host}/mcp

Server Details

Transport

HTTP

Authentication

None

Version

v0.4.0

Server Name

io.github.serkan-ozal/browser-devtools-mcp

Last Updated

Mar 9, 2026

Get Started

How to install and connect this MCP server.

Required Configuration

Environment variables you must provide when running this server.

Variable	Description	Required
`PLATFORM`	Platform: browser (default) or node for Node.js backend debugging.	Optional
`PORT`	Port for HTTP transport.	Optional
`SESSION_IDLE_SECONDS`	Idle session timeout (seconds).	Optional
`SESSION_IDLE_CHECK_SECONDS`	Interval for checking idle sessions (seconds).	Optional
`SESSION_CLOSE_ON_SOCKET_CLOSE`	Close session when socket closes.	Optional
`CONSOLE_MESSAGES_BUFFER_SIZE`	Maximum console messages to buffer.	Optional
`HTTP_REQUESTS_BUFFER_SIZE`	Maximum HTTP requests to buffer.	Optional
`BROWSER_SERVER_INSTRUCTIONS_ENABLE`	When true, include server instructions in MCP server info (browser platform). Default: true.	Optional
`BROWSER_POLICY_UI_DEBUGGING_ENABLE`	When true, include UI_DEBUGGING_POLICY in server policies (browser platform). Default: false.	Optional
`BROWSER_HEADLESS_ENABLE`	Run browser in headless mode.	Optional
`BROWSER_PERSISTENT_ENABLE`	Use persistent browser context (preserves cookies, localStorage, extensions).	Optional
`BROWSER_PERSISTENT_USER_DATA_DIR`	Directory for persistent browser context user data.	Optional
`BROWSER_USE_INSTALLED_ON_SYSTEM`	Use system-installed Chrome browser instead of Playwright's bundled browser.	Optional
`BROWSER_EXECUTABLE_PATH`	Custom browser executable path.	Optional
`BROWSER_LOCALE`	Browser locale (e.g., "en-US", "tr-TR").	Optional
`OTEL_ENABLE`	Enable OpenTelemetry integration.	Optional
`OTEL_SERVICE_NAME`	OpenTelemetry service name.	Optional
`OTEL_SERVICE_VERSION`	OpenTelemetry service version.	Optional
`OTEL_ASSETS_DIR`	Directory containing OpenTelemetry bundle files.	Optional
`OTEL_INSTRUMENTATION_USER_INTERACTION_EVENTS`	User interaction events to instrument (comma-separated, e.g., "click,submit").	Optional
`OTEL_EXPORTER_TYPE`	OpenTelemetry exporter type: "otlp/http", "console", or "none".	Optional
`OTEL_EXPORTER_HTTP_URL`	OpenTelemetry collector base URL (e.g., "http://localhost:4318").	Optional
`OTEL_EXPORTER_HTTP_HEADERS` secret	OpenTelemetry exporter HTTP headers (comma-separated key=value pairs).	Optional
`AWS_REGION`	AWS region for Bedrock usage.	Optional
`AWS_PROFILE`	AWS profile name for Bedrock usage.	Optional
`AMAZON_BEDROCK_ENABLE`	Enable Amazon Bedrock usage.	Optional
`AMAZON_BEDROCK_IMAGE_EMBED_MODEL_ID`	Amazon Bedrock image embedding model ID.	Optional
`AMAZON_BEDROCK_TEXT_EMBED_MODEL_ID`	Amazon Bedrock text embedding model ID.	Optional
`AMAZON_BEDROCK_VISION_MODEL_ID`	Amazon Bedrock vision model ID.	Optional
`FIGMA_ACCESS_TOKEN` secret	Figma API access token for design comparison.	Optional
`FIGMA_API_BASE_URL`	Figma API base URL.	Optional
`DAEMON_PORT`	Daemon mode port (CLI).	Optional
`DAEMON_SESSION_IDLE_SECONDS`	Daemon mode idle session timeout (seconds).	Optional
`DAEMON_SESSION_IDLE_CHECK_SECONDS`	Daemon mode idle session check interval (seconds).	Optional
`NODE_SERVER_INSTRUCTIONS_ENABLE`	When true, include server instructions in MCP server info (node platform). Default: true.	Optional
`NODE_POLICY_DEBUGGING_ENABLE`	When true, include NODE_DEBUGGING_POLICY in server policies (node platform). Default: false.	Optional
`NODE_INSPECTOR_HOST`	Inspector host for debug_connect when MCP runs in Docker (e.g. host.docker.internal). Default: 127.0.0.1.	Optional
`TOOL_OUTPUT_SCHEMA_DISABLE`	When true, omit tool output schema from MCP tool registration (can reduce token usage for some clients).	Optional
`AVAILABLE_TOOL_DOMAINS`	Comma-separated tool domains to enable (e.g. navigation,interaction,a11y). Unset = all tools. Browser: a11y, content, debug, figma, interaction, navigation, o11y, react, run, stub, sync. Node: debug, run.	Optional

browser-devtools-mcp

Connection Configuration

Server Details

Get Started

npm / npx

Required Configuration