Is io.github.HarimxChoi/google-surf-mcp safe to use?

io.github.HarimxChoi/google-surf-mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.

How do I install io.github.HarimxChoi/google-surf-mcp?

io.github.HarimxChoi/google-surf-mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What AI clients work with io.github.HarimxChoi/google-surf-mcp?

io.github.HarimxChoi/google-surf-mcp is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse and http transport.

Is io.github.HarimxChoi/google-surf-mcp actively maintained?

io.github.HarimxChoi/google-surf-mcp is actively maintained — last commit was 16 days ago. It has 268 GitHub stars.

io.github.HarimxChoi/google-surf-mcp

google-surf-mcp

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

268 393/wk GitHub npm

No known CVEs

No license

Actively maintained

Last commit 16d ago

Works with most clients

Transport: stdio, sse, http

0 tools

Grade F

MCPpedia last refreshed this data 4d ago

Edit this pageView history

Browser Search

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, sse, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "google-surf": {
      "args": [
        "-y",
        "google-surf-mcp"
      ],
      "command": "npx"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-harimxchoi-google-surf-mcp-harimxchoi)](https://mcppedia.org/s/io-github-harimxchoi-google-surf-mcp-harimxchoi)

Read me

What io.github.HarimxChoi/google-surf-mcp does

Demo only. Actual searches run headless by default (no visible browser). Set SURF_HEADLESS=false to make Chrome visible like in the clip above.

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

npx -y 'google-surf-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

59/100across 5 weighted dimensions

How we score →

0255075100

−41

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked google-surf-mcp against OSV.dev.

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is io.github.HarimxChoi/google-surf-mcp safe to use?: io.github.HarimxChoi/google-surf-mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install io.github.HarimxChoi/google-surf-mcp?: io.github.HarimxChoi/google-surf-mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What AI clients work with io.github.HarimxChoi/google-surf-mcp?: io.github.HarimxChoi/google-surf-mcp is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse and http transport.
Is io.github.HarimxChoi/google-surf-mcp actively maintained?: io.github.HarimxChoi/google-surf-mcp is actively maintained — last commit was 16 days ago. It has 268 GitHub stars.

Similar servers

Others in browser / search

View all →

Context797

Context7 Platform -- Up-to-date code documentation for LLMs and AI code editors

59.8k 2

Puppeteer MCP Server96

Browser automation with Puppeteer for web scraping and testing

88.9k 5

Tavily Mcp96

Production ready MCP server with real-time search, extract, map & crawl.

2.3k 4

Brave Search MCP Server96

Web and local search using Brave Search API

88.9k 2

MCP Security Weekly

Get CVE alerts and security updates for io.github.HarimxChoi/google-surf-mcp and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

Edit this pageView history

Browser Search

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, sse, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "google-surf": {
      "args": [
        "-y",
        "google-surf-mcp"
      ],
      "command": "npx"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-harimxchoi-google-surf-mcp-harimxchoi)](https://mcppedia.org/s/io-github-harimxchoi-google-surf-mcp-harimxchoi)

Read me

What io.github.HarimxChoi/google-surf-mcp does

Demo only. Actual searches run headless by default (no visible browser). Set SURF_HEADLESS=false to make Chrome visible like in the clip above.

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

npx -y 'google-surf-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

README

google-surf-mcp

English | 한국어

Demo only. Actual searches run headless by default (no visible browser). Set SURF_HEADLESS=false to make Chrome visible like in the clip above.

Google search MCP. No API key. Just works.

One MCP replaces three: search + URL fetcher + academic-paper extractor.

✅ Actually works (tested 6 free Google search MCPs, all failed)
✅ Search + URL + academic PDF extract in one MCP (replaces the search MCP + fetch MCP + academic-search MCP combo)
✅ Academic PDFs extracted inline: arxiv, biorxiv, Nature, OpenReview, NeurIPS, JMLR, PMLR, Springer, PubMed (via PMC)
✅ search_extract defaults to abstract mode (~1500 chars/result, token-cheap), mode="full" for whole bodies
✅ Sponsored ads + knowledge panels dropped (geometric verification, not just text matching)
✅ CAPTCHA recovery in 4 modes: OS notification (default) / SURF_HEADLESS=false / SURF_REMOTE_DEBUG / SURF_CLOUD_MODE (fail-fast)
✅ No API key, no proxies, no solver

5 tools: search / search_parallel / extract / search_extract / health

What

Plug it into any MCP client and you get Google search as a tool.

No CAPTCHA solver. When CAPTCHA fires on any tool, a Chrome window opens for a human to solve. Each solve preserves the profile's reputation with Google.

First call auto-bootstraps the warm profile. Designed for local use. For headless / serverless environments set SURF_CLOUD_MODE=true (fail-fast on CAPTCHA, worker pool disabled).

Numbers

	result
sequential	~1.5s/query (first call ~4s, includes setup)
parallel x4	~1.5s wall (first call ~9s, includes pool warm)
parallel x10	~4.5s wall
search_extract x5 (abstract, default)	~3s wall
search_extract x5 (full)	~5s wall (search + 5 parallel extracts)

Measured on a workstation with a 1Gb/s connection.

Stack

Playwright + persistent Chrome profile
playwright-extra stealth as a cascade fallback tier
Multi-strategy SERP parser + geometric verification (drops sponsored / knowledge_panel / related)
@llamaindex/liteparse for PDF text extraction (PDFium spatial parsing, optional OCR); Mozilla Readability + Turndown for HTML
Resource-blocked images / media / fonts for speed
Auto-bootstrap on first call; pool falls back to single-context after repeated warm failures
Self-healing: runtime parser-strategy reorder (deterministic) + daily cron repair PR (synthesis → optional LLM → triple-gate validation, human review)

Install

Requires Node 18+ and Google Chrome (or Chromium) on the system.

npx google-surf-mcp   # actual MCP - register in client config

First tool call auto-bootstraps the warm profile (you may see Chrome open briefly).

Or local clone:

git clone https://github.com/HarimxChoi/google-surf-mcp
cd google-surf-mcp
npm install

If auto-bootstrap fails (rare), run it manually:

npm run bootstrap

Override paths if needed:

CHROME_PATH=/path/to/chrome SURF_TZ=America/New_York npm run bootstrap

Use with Claude Code

Paste this into your ~/.claude.json:

{
  "mcpServers": {
    "google-surf": {
      "command": "npx",
      "args": ["-y", "google-surf-mcp"]
    }
  }
}

Restart Claude Code. Done. search, search_parallel, extract, search_extract, `hea

... View full README on GitHub

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

59/100across 5 weighted dimensions

How we score →

0255075100

−41

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked google-surf-mcp against OSV.dev.

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is io.github.HarimxChoi/google-surf-mcp safe to use?: io.github.HarimxChoi/google-surf-mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install io.github.HarimxChoi/google-surf-mcp?: io.github.HarimxChoi/google-surf-mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What AI clients work with io.github.HarimxChoi/google-surf-mcp?: io.github.HarimxChoi/google-surf-mcp is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse and http transport.
Is io.github.HarimxChoi/google-surf-mcp actively maintained?: io.github.HarimxChoi/google-surf-mcp is actively maintained — last commit was 16 days ago. It has 268 GitHub stars.