google-surf MCP Setup & Guide

{
  "id": "io.github.HarimxChoi/google-surf-mcp",
  "type": "mcp-server",
  "version": "1.1.3",
  "displayName": "google-surf-mcp",
  "description": "Web, academic and code search with graph RAG, data lineage, ontology and cross-project schema links.",
  "repository": {
    "url": "https://github.com/HarimxChoi/google-surf-mcp",
    "source": "github"
  },
  "distribution": {
    "packages": [
      {
        "registryType": "npm",
        "identifier": "google-surf-mcp",
        "version": "1.1.3",
        "transport": "stdio",
        "environmentVariables": [
          {
            "name": "SEARCH_API",
            "description": "SearchApi API key. Required only for SearchApi primary or fallback modes.",
            "isSecret": true
          },
          {
            "name": "SURF_SEARCH_PROVIDER",
            "description": "Provider for search and search_parallel: browser, searchapi, or fallback. Defaults to browser."
          },
          {
            "name": "SURF_SCHOLAR_PROVIDER",
            "description": "Provider for scholar_search: browser, searchapi, or fallback. Defaults to browser."
          },
          {
            "name": "SURF_BROWSER_ENGINE",
            "description": "Browser engine: auto, native, or playwright. Auto uses one hidden native Chrome broker shared across local MCP sessions."
          },
          {
            "name": "CHROME_PATH",
            "description": "Absolute path to the Chrome binary. Auto-detected on Windows/macOS/Linux when omitted."
          },
          {
            "name": "SURF_PROFILE_ROOT",
            "description": "Directory for the warm Chrome profile. Defaults to ~/.google-surf-mcp."
          },
          {
            "name": "SURF_RESEARCH",
            "description": "Enable local project memory and hybrid retrieval. Defaults to true."
          },
          {
            "name": "SURF_RETRIEVAL_MODE",
            "description": "Shared route for search and search_parallel: live or hybrid. Defaults to hybrid."
          },
          {
            "name": "SURF_RESEARCH_ROOT",
            "description": "Embedded SurrealDB data directory. Defaults to <profile>/research."
          },
          {
            "name": "SURF_RESEARCH_VECTOR_MODEL",
            "description": "Local model for HNSW retrieval and shared reranking. Defaults to Xenova/multilingual-e5-small; use off to disable."
          },
          {
            "name": "SURF_RESEARCH_VECTOR_LOW_MEMORY",
            "description": "Disable ONNX CPU memory arena and memory pattern. Defaults to true."
          },
          {
            "name": "SURF_RESEARCH_VECTOR_THREADS",
            "description": "ONNX intra-op thread count from 1 to 16. Defaults to 4."
          },
          {
            "name": "SURF_RESEARCH_REPO_AUTO",
            "description": "Sparse-index at most one eligible small GitHub repository per search call. Defaults to true."
          },
          {
            "name": "SURF_RESEARCH_REPO_AUTO_MAX_MB",
            "description": "Maximum searchable repository source-text size in MB. Assets are excluded. Defaults to 20."
          },
          {
            "name": "SURF_RESEARCH_REPO_AUTO_MAX_FILES",
            "description": "Maximum repository source file count for automatic indexing. Defaults to 2000."
          },
          {
            "name": "SURF_RESEARCH_BROKER_IDLE_MS",
            "description": "Shared research broker idle lifetime in milliseconds. Defaults to 60000."
          },
          {
            "name": "SURF_RESEARCH_READ_CONCURRENCY",
            "description": "Maximum concurrent research broker reads. Defaults to 4."
          },
          {
            "name": "SURF_RESEARCH_QUERY_TIMEOUT_MS",
            "description": "Timeout per embedded SurrealDB query in milliseconds. Defaults to 120000; timed-out retrieval lanes are reported as partial."
          },
          {
            "name": "GITHUB_TOKEN",
            "description": "Optional token that raises GitHub API limits for repository inspection.",
            "isSecret": true
          },
          {
            "name": "SURF_LOCALE",
            "description": "Browser locale, e.g. en-US."
          },
          {
            "name": "SURF_TZ",
            "description": "IANA timezone, e.g. America/New_York. Defaults to system timezone."
          },
          {
            "name": "SURF_HEADLESS",
            "description": "Controls Playwright extraction, compatibility, and recovery paths. Native search hides normal system Chrome and shows it only for CAPTCHA recovery."
          },
          {
            "name": "SURF_IDLE_CLOSE_MS",
            "description": "Idle ms before closing the sequential ctx and pool. 0 disables idle auto-close. Defaults to 30000."
          },
          {
            "name": "SURF_ALLOW_PRIVATE",
            "description": "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."
          },
          {
            "name": "SURF_LLM_HEAL",
            "description": "Enable the optional workflow-only LLM selector repair path. Defaults to false."
          },
          {
            "name": "SURF_LLM_PROVIDER",
            "description": "LLM selector repair provider: anthropic or orcarouter. Defaults to anthropic."
          },
          {
            "name": "SURF_LLM_MODEL",
            "description": "Optional model override. OrcaRouter defaults to orcarouter/auto."
          },
          {
            "name": "ANTHROPIC_API_KEY",
            "description": "Anthropic API key for optional LLM-assisted selector repair.",
            "isSecret": true
          },
          {
            "name": "ORCAROUTER_API_KEY",
            "description": "OrcaRouter API key for optional LLM-assisted selector repair.",
            "isSecret": true
          }
        ]
      }
    ],
    "remotes": []
  },
  "dependencies": [],
  "installTargets": [
    "claude-code",
    "claude-desktop",
    "cursor",
    "vscode",
    "trae",
    "cherry-studio",
    "lingma",
    "windsurf",
    "cline",
    "workbuddy"
  ],
  "keywords": [],
  "provenance": {
    "origin": "official-mcp-registry",
    "originalId": "io.github.HarimxChoi/google-surf-mcp",
    "originalUrl": "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.HarimxChoi%2Fgoogle-surf-mcp/versions/latest",
    "isOfficial": true,
    "status": "active"
  }
}