Browser MCP

This is a fork of @browsermcp/mcp that fixes some reliability issues.

Installation

Add this to the mcp.json file

{
  "mcpServers": {
    "browsermcp": {
      "command": "npx",
      "args": ["@conradkoh/browsermcp@latest"]
    }
  }
}

Finding Logs

The Browser MCP server logs its activity to a temporary file. When the server exits or crashes, the full path to this log file will be printed to stderr.

To find and view the logs:

1. Look for a message on stderr (your terminal output) like: Exiting. Full logs available at: /var/folders/.../browsermcp-YYYY-MM-DDTHH-MM-SS-PID.log or FATAL ERROR: ... Full logs available at: /var/folders/.../browsermcp-YYYY-MM-DDTHH-MM-SS-PID.log

2. To view the most recent logs in real-time, you can use the following command (this might take a few seconds):

   tail -f $(find /var/folders /tmp -name "browsermcp-*.log" 2>/dev/null -print0 | xargs -0 ls -t | head -n 1)

   (The 2>/dev/null directly on the find command will suppress "Permission denied" and other errors from find itself.)

3. To view the entire content of the most recent log file:

   cat $(find /var/folders /tmp -name "browsermcp-*.log" 2>/dev/null -print0 | xargs -0 ls -t | head -n 1)

Improvements

1. Improved logging: Logs are now more reliably written to a temporary directory.
2. Enhanced exit code handling: Implemented a finite state machine for better management of exit codes.
3. (WIP) Browser Gateway for multi-instance stability: A browser gateway has been added to resolve conflicts when multiple MCP servers connect to the browser, preventing crashes that previously required server restarts.