io.github.HarimxChoi/google-surf-mcpsearch

google-surf-mcp

Verified · 26 days ago

Web, academic and code search with graph RAG, data lineage, ontology and cross-project schema links.

Install

claude mcp add google-surf-mcp -- npx -y [email protected]

Requires: SEARCH_API, SURF_SEARCH_PROVIDER, SURF_SCHOLAR_PROVIDER, SURF_BROWSER_ENGINE, CHROME_PATH, SURF_PROFILE_ROOT, SURF_RESEARCH, SURF_RETRIEVAL_MODE, SURF_RESEARCH_ROOT, SURF_RESEARCH_VECTOR_MODEL, SURF_RESEARCH_VECTOR_LOW_MEMORY, SURF_RESEARCH_VECTOR_THREADS, SURF_RESEARCH_REPO_AUTO, SURF_RESEARCH_REPO_AUTO_MAX_MB, SURF_RESEARCH_REPO_AUTO_MAX_FILES, SURF_RESEARCH_BROKER_IDLE_MS, SURF_RESEARCH_READ_CONCURRENCY, SURF_RESEARCH_QUERY_TIMEOUT_MS, GITHUB_TOKEN, SURF_LOCALE, SURF_TZ, SURF_HEADLESS, SURF_IDLE_CLOSE_MS, SURF_ALLOW_PRIVATE, SURF_LLM_HEAL, SURF_LLM_PROVIDER, SURF_LLM_MODEL, ANTHROPIC_API_KEY, ORCAROUTER_API_KEY

Our take

Free Google search via Playwright and a warm persistent Chrome profile — no API key, no proxies, no CAPTCHA-solver service — plus URL fetching and inline academic-PDF extraction rolled into one server. The human-in-the-loop CAPTCHA recovery is honest engineering: when Google challenges, a browser window opens for you to solve it. Fast and token-conscious in practice, but it's SERP scraping on your own IP, designed for a local workstation, and the project is only a few months old.

reviewed by hand · 2026-07-05

Something wrong or dead here? Report it