io.github.HarimxChoi/google-surf-mcp

{
  "_meta": {
    "io.modelcontextprotocol.registry/official": {
      "status": "active",
      "isLatest": true,
      "updatedAt": "2026-10-20T01:01:10.879215Z",
      "publishedAt": "2026-10-20T01:01:10.879215Z",
      "statusChangedAt": "2026-10-20T01:01:10.879215Z"
    }
  },
  "server": {
    "name": "io.github.HarimxChoi/google-surf-mcp",
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
    "version": "1.1.4",
    "packages": [
      {
        "version": "1.1.4",
        "transport": {
          "type": "stdio"
        },
        "identifier": "google-surf-mcp",
        "registryType": "npm",
        "environmentVariables": [
          {
            "name": "SEARCH_API",
            "format": "string",
            "isSecret": true,
            "description": "SearchApi API key. Required only for SearchApi primary or fallback modes."
          },
          {
            "name": "SURF_SEARCH_PROVIDER",
            "format": "string",
            "description": "Provider for search and search_parallel: browser, searchapi, or fallback. Defaults to browser."
          },
          {
            "name": "SURF_SCHOLAR_PROVIDER",
            "format": "string",
            "description": "Provider for scholar_search: browser, searchapi, or fallback. Defaults to browser."
          },
          {
            "name": "SURF_BROWSER_ENGINE",
            "format": "string",
            "description": "Browser engine: auto, native, or playwright. Auto uses one hidden native Chrome broker shared across local MCP sessions."
          },
          {
            "name": "CHROME_PATH",
            "format": "string",
            "description": "Absolute path to the Chrome binary. Auto-detected on Windows/macOS/Linux when omitted."
          },
          {
            "name": "SURF_PROFILE_ROOT",
            "format": "string",
            "description": "Directory for the warm Chrome profile. Defaults to ~/.google-surf-mcp."
          },
          {
            "name": "SURF_RESEARCH",
            "format": "string",
            "description": "Enable local project memory and hybrid retrieval. Defaults to true."
          },
          {
            "name": "SURF_RETRIEVAL_MODE",
            "format": "string",
            "description": "Shared route for search and search_parallel: live or hybrid. Defaults to hybrid."
          },
          {
            "name": "SURF_RESEARCH_ROOT",
            "format": "string",
            "description": "Embedded SurrealDB data directory. Defaults to <profile>/research."
          },
          {
            "name": "SURF_RESEARCH_VECTOR_MODEL",
            "format": "string",
            "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",
            "format": "string",
            "description": "Disable ONNX CPU memory arena and memory pattern. Defaults to true."
          },
          {
            "name": "SURF_RESEARCH_VECTOR_THREADS",
            "format": "string",
            "description": "ONNX intra-op thread count from 1 to 16. Defaults to 4."
          },
          {
            "name": "SURF_RESEARCH_REPO_AUTO",
            "format": "string",
            "description": "Sparse-index at most one eligible small GitHub repository per search call. Defaults to true."
          },
          {
            "name": "SURF_RESEARCH_REPO_AUTO_MAX_MB",
            "format": "string",
            "description": "Maximum searchable repository source-text size in MB. Assets are excluded. Defaults to 20."
          },
          {
            "name": "SURF_RESEARCH_REPO_AUTO_MAX_FILES",
            "format": "string",
            "description": "Maximum repository source file count for automatic indexing. Defaults to 2000."
          },
          {
            "name": "SURF_RESEARCH_BROKER_IDLE_MS",
            "format": "string",
            "description": "Shared research broker idle lifetime in milliseconds. Defaults to 60000."
          },
          {
            "name": "SURF_RESEARCH_READ_CONCURRENCY",
            "format": "string",
            "description": "Maximum concurrent research broker reads. Defaults to 4."
          },
          {
            "name": "SURF_RESEARCH_QUERY_TIMEOUT_MS",
            "format": "string",
            "description": "Timeout per embedded SurrealDB query in milliseconds. Defaults to 120000; timed-out retrieval lanes are reported as partial."
          },
          {
            "name": "GITHUB_TOKEN",
            "format": "string",
            "isSecret": true,
            "description": "Optional token that raises GitHub API limits for repository inspection."
          },
          {
            "name": "SURF_LOCALE",
            "format": "string",
            "description": "Browser locale, e.g. en-US."
          },
          {
            "name": "SURF_TZ",
            "format": "string",
            "description": "IANA timezone, e.g. America/New_York. Defaults to system timezone."
          },
          {
            "name": "SURF_HEADLESS",
            "format": "string",
            "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",
            "format": "string",
            "description": "Idle ms before closing the sequential ctx and pool. 0 disables idle auto-close. Defaults to 30000."
          },
          {
            "name": "SURF_ALLOW_PRIVATE",
            "format": "string",
            "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",
            "format": "string",
            "description": "Enable the optional workflow-only LLM selector repair path. Defaults to false."
          },
          {
            "name": "SURF_LLM_PROVIDER",
            "format": "string",
            "description": "LLM selector repair provider: anthropic or orcarouter. Defaults to anthropic."
          },
          {
            "name": "SURF_LLM_MODEL",
            "format": "string",
            "description": "Optional model override. OrcaRouter defaults to orcarouter/auto."
          },
          {
            "name": "ANTHROPIC_API_KEY",
            "format": "string",
            "isSecret": true,
            "description": "Anthropic API key for optional LLM-assisted selector repair."
          },
          {
            "name": "ORCAROUTER_API_KEY",
            "format": "string",
            "isSecret": true,
            "description": "OrcaRouter API key for optional LLM-assisted selector repair."
          }
        ]
      }
    ],
    "repository": {
      "url": "https://github.com/HarimxChoi/google-surf-mcp",
      "source": "github"
    },
    "description": "Web, academic and code search with graph RAG, data lineage, ontology and cross-project schema links."
  }
}