Skip to content
mcp/harbor
Windsurf

google surf mcp for Windsurf

io.github.harimxchoi/google-surf-mcp

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

client:Windsurf transport:stdio runtime:npm

Install google surf mcp in Windsurf

~/.codeium/windsurf/mcp_config.json · windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

Held in this page only — never stored, logged, or sent anywhere but back to your screen. 

{
  "mcpServers": {
    "google-surf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "google-surf-mcp"
      ],
      "env": {
        "SEARCH_API": "<SEARCH_API>",
        "SURF_SEARCH_PROVIDER": "<SURF_SEARCH_PROVIDER>",
        "SURF_SCHOLAR_PROVIDER": "<SURF_SCHOLAR_PROVIDER>",
        "SURF_BROWSER_ENGINE": "<SURF_BROWSER_ENGINE>",
        "CHROME_PATH": "<CHROME_PATH>",
        "SURF_PROFILE_ROOT": "<SURF_PROFILE_ROOT>",
        "SURF_RESEARCH": "<SURF_RESEARCH>",
        "SURF_RETRIEVAL_MODE": "<SURF_RETRIEVAL_MODE>",
        "SURF_RESEARCH_ROOT": "<SURF_RESEARCH_ROOT>",
        "SURF_RESEARCH_VECTOR_MODEL": "<SURF_RESEARCH_VECTOR_MODEL>",
        "SURF_RESEARCH_VECTOR_LOW_MEMORY": "<SURF_RESEARCH_VECTOR_LOW_MEMORY>",
        "SURF_RESEARCH_VECTOR_THREADS": "<SURF_RESEARCH_VECTOR_THREADS>",
        "SURF_RESEARCH_REPO_AUTO": "<SURF_RESEARCH_REPO_AUTO>",
        "SURF_RESEARCH_REPO_AUTO_MAX_MB": "<SURF_RESEARCH_REPO_AUTO_MAX_MB>",
        "SURF_RESEARCH_REPO_AUTO_MAX_FILES": "<SURF_RESEARCH_REPO_AUTO_MAX_FILES>",
        "SURF_RESEARCH_BROKER_IDLE_MS": "<SURF_RESEARCH_BROKER_IDLE_MS>",
        "SURF_RESEARCH_READ_CONCURRENCY": "<SURF_RESEARCH_READ_CONCURRENCY>",
        "SURF_RESEARCH_QUERY_TIMEOUT_MS": "<SURF_RESEARCH_QUERY_TIMEOUT_MS>",
        "GITHUB_TOKEN": "<GITHUB_TOKEN>",
        "SURF_LOCALE": "<SURF_LOCALE>",
        "SURF_TZ": "<SURF_TZ>",
        "SURF_HEADLESS": "<SURF_HEADLESS>",
        "SURF_IDLE_CLOSE_MS": "<SURF_IDLE_CLOSE_MS>",
        "SURF_ALLOW_PRIVATE": "<SURF_ALLOW_PRIVATE>",
        "SURF_LLM_HEAL": "<SURF_LLM_HEAL>",
        "SURF_LLM_PROVIDER": "<SURF_LLM_PROVIDER>",
        "SURF_LLM_MODEL": "<SURF_LLM_MODEL>",
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "ORCAROUTER_API_KEY": "<ORCAROUTER_API_KEY>"
      }
    }
  }
}

Global only — Windsurf has no per-project MCP config. Refresh Cascade after saving. Windsurf docs

google surf mcp in other clients

google surf mcp MCP server