io.github.HarimxChoi/google-surf-mcp

io.github.HarimxChoi/google-surf-mcp·v0.3.2·Browser Automation

Quality Score

/100

Google search via Playwright with a warm Chrome profile. No API key, no proxies.

Repository →

§01 Install

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "google-surf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "google-surf-mcp"
      ],
      "env": {
        "CHROME_PATH": "<chrome_path>",
        "SURF_PROFILE_ROOT": "<surf_profile_root>",
        "SURF_LOCALE": "<surf_locale>",
        "SURF_TZ": "<surf_tz>"
      }
    }
  }
}

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "google-surf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "google-surf-mcp"
      ],
      "env": {
        "CHROME_PATH": "<chrome_path>",
        "SURF_PROFILE_ROOT": "<surf_profile_root>",
        "SURF_LOCALE": "<surf_locale>",
        "SURF_TZ": "<surf_tz>"
      }
    }
  }
}

Cline (cline_mcp_settings.json)

npx -y google-surf-mcp

§02 Environment variables

CHROME_PATH

Absolute path to the Chrome binary. Auto-detected on Windows/macOS/Linux when omitted.

SURF_PROFILE_ROOT

Directory for the warm Chrome profile. Defaults to ~/.google-surf-mcp.

SURF_LOCALE

Browser locale, e.g. en-US.

SURF_TZ

IANA timezone, e.g. America/New_York. Defaults to system timezone.

§03 MCP Quality Score · methodology

freshness

completeness

installability

documentation

stability

§04 Alternatives in Browser Automation

ai.smithery/ImRonAI-mcp-server-browserbase

Automate cloud browsers to navigate websites, interact with elements, and extract structured data.…

ai.smithery/browserbasehq-mcp-browserbase

Provides cloud browser automation capabilities using Stagehand and Browserbase, enabling LLMs to i…

com.onkernel/kernel-mcp-server

Access Kernel's cloud-based browsers and app actions via MCP (remote HTTP + OAuth).