How do I install google-surf-mcp?

Pick a client above and copy the generated config. Cursor and VS Code also have a deep link when the server can run locally or remotely.

Is google-surf-mcp official?

No. Registry-listed is not the same as vendor-official. Read the methodology for the difference.

How is the trust score calculated?

This listing scores 50 (Fair). The formula is published on the methodology page.

MCPpedia

google-surf-mcp MCP Server | MCPpedia

google-surf-mcp MCP Server

Name: google-surf-mcp MCP Server
Author: harimxchoi

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

Tools Versions Alternatives

Registryharimxchoi

50Fair

Install

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

{
  "mcpServers": {
    "harimxchoi-google-surf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "google-surf-mcp@1.1.3"
      ],
      "env": {
        "SEARCH_API": "YOUR_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": "YOUR_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": "YOUR_ANTHROPIC_API_KEY",
        "ORCAROUTER_API_KEY": "YOUR_ORCAROUTER_API_KEY"
      }
    }
  }
}

Install guide

Related servers

SuperLocalMemory

78Good

Local-first memory for AI agents: recall with sources, answer checks, documents, mesh, governance.

Registryqualixar249 stars1.3K/wk

Codebase Memory

77Good

Codebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens.

Environment

Name	Required	Notes
SEARCH_API	No	SearchApi API key. Required only for SearchApi primary or fallback modes. Secret.
SURF_SEARCH_PROVIDER	No	Provider for search and search_parallel: browser, searchapi, or fallback. Defaults to browser.
SURF_SCHOLAR_PROVIDER	No	Provider for scholar_search: browser, searchapi, or fallback. Defaults to browser.
SURF_BROWSER_ENGINE	No	Browser engine: auto, native, or playwright. Auto uses one hidden native Chrome broker shared across local MCP sessions.
CHROME_PATH	No	Absolute path to the Chrome binary. Auto-detected on Windows/macOS/Linux when omitted.
SURF_PROFILE_ROOT	No	Directory for the warm Chrome profile. Defaults to ~/.google-surf-mcp.
SURF_RESEARCH	No	Enable local project memory and hybrid retrieval. Defaults to true.
SURF_RETRIEVAL_MODE	No	Shared route for search and search_parallel: live or hybrid. Defaults to hybrid.
SURF_RESEARCH_ROOT	No	Embedded SurrealDB data directory. Defaults to <profile>/research.
SURF_RESEARCH_VECTOR_MODEL	No	Local model for HNSW retrieval and shared reranking. Defaults to Xenova/multilingual-e5-small; use off to disable.
SURF_RESEARCH_VECTOR_LOW_MEMORY	No	Disable ONNX CPU memory arena and memory pattern. Defaults to true.
SURF_RESEARCH_VECTOR_THREADS	No	ONNX intra-op thread count from 1 to 16. Defaults to 4.
SURF_RESEARCH_REPO_AUTO	No	Sparse-index at most one eligible small GitHub repository per search call. Defaults to true.
SURF_RESEARCH_REPO_AUTO_MAX_MB	No	Maximum searchable repository source-text size in MB. Assets are excluded. Defaults to 20.
SURF_RESEARCH_REPO_AUTO_MAX_FILES	No	Maximum repository source file count for automatic indexing. Defaults to 2000.
SURF_RESEARCH_BROKER_IDLE_MS	No	Shared research broker idle lifetime in milliseconds. Defaults to 60000.
SURF_RESEARCH_READ_CONCURRENCY	No	Maximum concurrent research broker reads. Defaults to 4.
SURF_RESEARCH_QUERY_TIMEOUT_MS	No	Timeout per embedded SurrealDB query in milliseconds. Defaults to 120000; timed-out retrieval lanes are reported as partial.
GITHUB_TOKEN	No	Optional token that raises GitHub API limits for repository inspection. Secret.
SURF_LOCALE	No	Browser locale, e.g. en-US.
SURF_TZ	No	IANA timezone, e.g. America/New_York. Defaults to system timezone.
SURF_HEADLESS	No	Controls Playwright extraction, compatibility, and recovery paths. Native search hides normal system Chrome and shows it only for CAPTCHA recovery.
SURF_IDLE_CLOSE_MS	No	Idle ms before closing the sequential ctx and pool. 0 disables idle auto-close. Defaults to 30000.
SURF_ALLOW_PRIVATE	No	Set to 'true' to allow extract on private/loopback addresses (localhost, 10.x, 192.168.x, 169.254.x, etc). Default blocks them as an SSRF guard.
SURF_LLM_HEAL	No	Enable the optional workflow-only LLM selector repair path. Defaults to false.
SURF_LLM_PROVIDER	No	LLM selector repair provider: anthropic or orcarouter. Defaults to anthropic.
SURF_LLM_MODEL	No	Optional model override. OrcaRouter defaults to orcarouter/auto.
ANTHROPIC_API_KEY	No	Anthropic API key for optional LLM-assisted selector repair. Secret.
ORCAROUTER_API_KEY	No	OrcaRouter API key for optional LLM-assisted selector repair. Secret.

google-surf-mcp MCP Server

Install

Related servers

SuperLocalMemory

Codebase Memory

Environment

Tools

About

FAQ

Reviews

Firecrawl MCP Server

Zotero MCP

haiku.rag

openInvest