browser-devtools-mcp

{
  "id": "io.github.serkan-ozal/browser-devtools-mcp",
  "type": "mcp-server",
  "version": "0.9.1",
  "displayName": "browser-devtools-mcp",
  "description": "Playwright browser & Node.js MCP. ARIA refs, screenshots, ref-based interactions.",
  "repository": {
    "url": "https://github.com/serkan-ozal/browser-devtools-mcp",
    "source": "github"
  },
  "homepage": "https://github.com/serkan-ozal/browser-devtools-mcp",
  "distribution": {
    "packages": [
      {
        "registryType": "npm",
        "identifier": "browser-devtools-mcp",
        "version": "0.9.1",
        "transport": "stdio",
        "environmentVariables": [
          {
            "name": "PLATFORM",
            "description": "Platform: browser (default) or node for Node.js backend debugging."
          },
          {
            "name": "PORT",
            "description": "Port for HTTP transport."
          },
          {
            "name": "SESSION_IDLE_SECONDS",
            "description": "Idle session timeout (seconds)."
          },
          {
            "name": "SESSION_IDLE_CHECK_SECONDS",
            "description": "Interval for checking idle sessions (seconds)."
          },
          {
            "name": "SESSION_CLOSE_ON_SOCKET_CLOSE",
            "description": "Close session when socket closes."
          },
          {
            "name": "CONSOLE_MESSAGES_BUFFER_SIZE",
            "description": "Maximum console messages to buffer."
          },
          {
            "name": "HTTP_REQUESTS_BUFFER_SIZE",
            "description": "Maximum HTTP requests to buffer."
          },
          {
            "name": "BROWSER_SERVER_INSTRUCTIONS_ENABLE",
            "description": "When true, include server instructions in MCP server info (browser platform). Default: true."
          },
          {
            "name": "BROWSER_POLICY_UI_DEBUGGING_ENABLE",
            "description": "When true, include UI_DEBUGGING_POLICY in server policies (browser platform). Default: false."
          },
          {
            "name": "BROWSER_HEADLESS_ENABLE",
            "description": "Run browser in headless mode."
          },
          {
            "name": "BROWSER_PERSISTENT_ENABLE",
            "description": "Use persistent browser context (preserves cookies, localStorage, extensions)."
          },
          {
            "name": "BROWSER_CDP_ENDPOINT_URL",
            "description": "CDP attach: http(s) root or ws(s) URL. Resolves via /json/version, /json/list, or ws /devtools/browser (Chrome 136+). Mutually exclusive with BROWSER_PERSISTENT_ENABLE."
          },
          {
            "name": "BROWSER_CDP_ENABLE",
            "description": "When true and no BROWSER_CDP_ENDPOINT_URL: probe 127.0.0.1:9222 then :9229 for CDP. Else use BROWSER_CDP_ENDPOINT_URL or default http://127.0.0.1:9222."
          },
          {
            "name": "BROWSER_CDP_OPEN_INSPECT",
            "description": "On loopback CDP failure, if Chrome is running, open chrome://inspect/#remote-debugging. Default true. Set false to disable."
          },
          {
            "name": "BROWSER_PERSISTENT_USER_DATA_DIR",
            "description": "Directory for persistent browser context user data."
          },
          {
            "name": "BROWSER_USE_INSTALLED_ON_SYSTEM",
            "description": "Use system-installed Chrome browser instead of Playwright's bundled browser."
          },
          {
            "name": "BROWSER_EXECUTABLE_PATH",
            "description": "Custom browser executable path."
          },
          {
            "name": "BROWSER_CHROMIUM_SANDBOX",
            "description": "When false, launches Chromium with --no-sandbox. Required for Docker/Lambda/CI."
          },
          {
            "name": "BROWSER_LAUNCH_ARGS",
            "description": "Extra Chromium launch args (comma-separated)."
          },
          {
            "name": "BROWSER_ALLOWED_DOMAINS",
            "description": "Comma-separated list of allowed hostnames. When set, all requests to non-matching hosts are aborted. Subdomains match automatically."
          },
          {
            "name": "BROWSER_LOCALE",
            "description": "Browser locale (e.g., \"en-US\", \"tr-TR\")."
          },
          {
            "name": "OTEL_ENABLE",
            "description": "Enable OpenTelemetry integration."
          },
          {
            "name": "OTEL_SERVICE_NAME",
            "description": "OpenTelemetry service name."
          },
          {
            "name": "OTEL_SERVICE_VERSION",
            "description": "OpenTelemetry service version."
          },
          {
            "name": "OTEL_ASSETS_DIR",
            "description": "Directory containing OpenTelemetry bundle files."
          },
          {
            "name": "OTEL_INSTRUMENTATION_USER_INTERACTION_EVENTS",
            "description": "User interaction events to instrument (comma-separated, e.g., \"click,submit\")."
          },
          {
            "name": "OTEL_EXPORTER_TYPE",
            "description": "OpenTelemetry exporter type: \"otlp/http\", \"console\", or \"none\"."
          },
          {
            "name": "OTEL_EXPORTER_HTTP_URL",
            "description": "OpenTelemetry collector base URL (e.g., \"http://localhost:4318\")."
          },
          {
            "name": "OTEL_EXPORTER_HTTP_HEADERS",
            "description": "OpenTelemetry exporter HTTP headers (comma-separated key=value pairs).",
            "isSecret": true
          },
          {
            "name": "AWS_REGION",
            "description": "AWS region for Bedrock usage."
          },
          {
            "name": "AWS_PROFILE",
            "description": "AWS profile name for Bedrock usage."
          },
          {
            "name": "AMAZON_BEDROCK_ENABLE",
            "description": "Enable Amazon Bedrock usage."
          },
          {
            "name": "AMAZON_BEDROCK_IMAGE_EMBED_MODEL_ID",
            "description": "Amazon Bedrock image embedding model ID."
          },
          {
            "name": "AMAZON_BEDROCK_TEXT_EMBED_MODEL_ID",
            "description": "Amazon Bedrock text embedding model ID."
          },
          {
            "name": "AMAZON_BEDROCK_VISION_MODEL_ID",
            "description": "Amazon Bedrock vision model ID."
          },
          {
            "name": "FIGMA_ACCESS_TOKEN",
            "description": "Figma API access token for design comparison.",
            "isSecret": true
          },
          {
            "name": "FIGMA_API_BASE_URL",
            "description": "Figma API base URL."
          },
          {
            "name": "DAEMON_PORT",
            "description": "Daemon mode port (CLI)."
          },
          {
            "name": "DAEMON_SESSION_IDLE_SECONDS",
            "description": "Daemon mode idle session timeout (seconds)."
          },
          {
            "name": "DAEMON_SESSION_IDLE_CHECK_SECONDS",
            "description": "Daemon mode idle session check interval (seconds)."
          },
          {
            "name": "NODE_SERVER_INSTRUCTIONS_ENABLE",
            "description": "When true, include server instructions in MCP server info (node platform). Default: true."
          },
          {
            "name": "NODE_POLICY_DEBUGGING_ENABLE",
            "description": "When true, include NODE_DEBUGGING_POLICY in server policies (node platform). Default: false."
          },
          {
            "name": "NODE_INSPECTOR_HOST",
            "description": "Inspector host for debug_connect when MCP runs in Docker (e.g. host.docker.internal). Default: 127.0.0.1."
          },
          {
            "name": "TOOL_OUTPUT_SCHEMA_DISABLE",
            "description": "When true, omit tool output schema from MCP tool registration (can reduce token usage for some clients)."
          },
          {
            "name": "AVAILABLE_TOOL_DOMAINS",
            "description": "Comma-separated tool domains to enable (e.g. navigation,interaction,a11y,scenario). Unset = all tools. Browser: a11y, content, debug, figma, interaction, navigation, o11y, react, scenario, run, stub, sync. Node: debug, run."
          },
          {
            "name": "WORKING_DIR",
            "description": "Working directory for project-level config (.browser-devtools-mcp/). Default: process.cwd()."
          },
          {
            "name": "SEARCH_STRATEGY",
            "description": "Search strategy: SIMPLE (default, minisearch + stemmer) or FTS5 (better-sqlite3, optional dep)."
          },
          {
            "name": "SCENARIO_SEARCH_STRATEGY",
            "description": "Override SEARCH_STRATEGY for scenario search only."
          }
        ]
      }
    ],
    "remotes": [
      {
        "transport": "streamable-http",
        "url": "https://{your_mcp_server_host}/mcp"
      }
    ]
  },
  "dependencies": [],
  "installTargets": [
    "claude-code",
    "claude-desktop",
    "cursor",
    "vscode"
  ],
  "keywords": [],
  "provenance": {
    "origin": "official-mcp-registry",
    "originalId": "io.github.serkan-ozal/browser-devtools-mcp",
    "originalUrl": "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.serkan-ozal%2Fbrowser-devtools-mcp/versions/latest",
    "isOfficial": true,
    "status": "active"
  }
}