Koskamo

google-surf-mcp

An MCP server that turns Google Search, Scholar, and GitHub repositories into an automatic local knowledge graph for AI agents. It supports web, academic, and codebase search with graph RAG, data lineage, and cross-project schema links, storing results in a project-scoped local knowledge graph to reduce repeated work.

Package and access

Local package with source-attributed installation metadata. Koskamo does not execute packages during review.

google-surf-mcp logo, by HarimxChoiCommunity listingLocal stdioSource reviewed; not executedPublished by HarimxChoi
Vendor documentation

What you can do with it

  • Perform web, academic, and codebase searches
  • Extract metadata and text from HTML and PDF documents
  • Build and query a local knowledge graph for research
  • Manage project memory and data lineage

Source and maintenance

Community listingRegistry 1.1.5
mcp-registry: io.github.HarimxChoi/google-surf-mcp@1.1.5Source repository
Maintenance checked

Packages and installation

Source-provided package data. Koskamo has not executed or live-probed this package.

google-surf-mcp 1.1.5

npm
google-surf-mcp package definition
{
  "version": "1.1.5",
  "transport": "stdio",
  "identifier": "google-surf-mcp",
  "registryType": "npm",
  "environmentVariables": [
    {
      "name": "SEARCH_API",
      "format": "string",
      "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",
      "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",
      "description": "Anthropic API key for optional LLM-assisted selector repair."
    },
    {
      "name": "ORCAROUTER_API_KEY",
      "format": "string",
      "description": "OrcaRouter API key for optional LLM-assisted selector repair."
    }
  ]
}

Tools

Reported by the attributed source; not independently observed by Koskamo.

No tool definitions available.

Connect from your client

Each snippet configures the same source-provided package; replace placeholders before use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Cursor

Merge this local stdio configuration, replace every placeholder environment value, and restart Cursor. Koskamo has not executed this package.
Cursor configuration
{
  "mcpServers": {
    "google-surf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "google-surf-mcp@1.1.5"
      ],
      "env": {
        "SEARCH_API": "<YOUR_SEARCH_API>",
        "SURF_SEARCH_PROVIDER": "<YOUR_SURF_SEARCH_PROVIDER>",
        "SURF_SCHOLAR_PROVIDER": "<YOUR_SURF_SCHOLAR_PROVIDER>",
        "SURF_BROWSER_ENGINE": "<YOUR_SURF_BROWSER_ENGINE>",
        "CHROME_PATH": "<YOUR_CHROME_PATH>",
        "SURF_PROFILE_ROOT": "<YOUR_SURF_PROFILE_ROOT>",
        "SURF_RESEARCH": "<YOUR_SURF_RESEARCH>",
        "SURF_RETRIEVAL_MODE": "<YOUR_SURF_RETRIEVAL_MODE>",
        "SURF_RESEARCH_ROOT": "<YOUR_SURF_RESEARCH_ROOT>",
        "SURF_RESEARCH_VECTOR_MODEL": "<YOUR_SURF_RESEARCH_VECTOR_MODEL>",
        "SURF_RESEARCH_VECTOR_LOW_MEMORY": "<YOUR_SURF_RESEARCH_VECTOR_LOW_MEMORY>",
        "SURF_RESEARCH_VECTOR_THREADS": "<YOUR_SURF_RESEARCH_VECTOR_THREADS>",
        "SURF_RESEARCH_REPO_AUTO": "<YOUR_SURF_RESEARCH_REPO_AUTO>",
        "SURF_RESEARCH_REPO_AUTO_MAX_MB": "<YOUR_SURF_RESEARCH_REPO_AUTO_MAX_MB>",
        "SURF_RESEARCH_REPO_AUTO_MAX_FILES": "<YOUR_SURF_RESEARCH_REPO_AUTO_MAX_FILES>",
        "SURF_RESEARCH_BROKER_IDLE_MS": "<YOUR_SURF_RESEARCH_BROKER_IDLE_MS>",
        "SURF_RESEARCH_READ_CONCURRENCY": "<YOUR_SURF_RESEARCH_READ_CONCURRENCY>",
        "SURF_RESEARCH_QUERY_TIMEOUT_MS": "<YOUR_SURF_RESEARCH_QUERY_TIMEOUT_MS>",
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>",
        "SURF_LOCALE": "<YOUR_SURF_LOCALE>",
        "SURF_TZ": "<YOUR_SURF_TZ>",
        "SURF_HEADLESS": "<YOUR_SURF_HEADLESS>",
        "SURF_IDLE_CLOSE_MS": "<YOUR_SURF_IDLE_CLOSE_MS>",
        "SURF_ALLOW_PRIVATE": "<YOUR_SURF_ALLOW_PRIVATE>",
        "SURF_LLM_HEAL": "<YOUR_SURF_LLM_HEAL>",
        "SURF_LLM_PROVIDER": "<YOUR_SURF_LLM_PROVIDER>",
        "SURF_LLM_MODEL": "<YOUR_SURF_LLM_MODEL>",
        "ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
        "ORCAROUTER_API_KEY": "<YOUR_ORCAROUTER_API_KEY>"
      }
    }
  }
}

Cline

Merge this local stdio configuration, replace every placeholder environment value, and restart Cline. Koskamo has not executed this package.
Cline configuration
{
  "mcpServers": {
    "google-surf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "google-surf-mcp@1.1.5"
      ],
      "env": {
        "SEARCH_API": "<YOUR_SEARCH_API>",
        "SURF_SEARCH_PROVIDER": "<YOUR_SURF_SEARCH_PROVIDER>",
        "SURF_SCHOLAR_PROVIDER": "<YOUR_SURF_SCHOLAR_PROVIDER>",
        "SURF_BROWSER_ENGINE": "<YOUR_SURF_BROWSER_ENGINE>",
        "CHROME_PATH": "<YOUR_CHROME_PATH>",
        "SURF_PROFILE_ROOT": "<YOUR_SURF_PROFILE_ROOT>",
        "SURF_RESEARCH": "<YOUR_SURF_RESEARCH>",
        "SURF_RETRIEVAL_MODE": "<YOUR_SURF_RETRIEVAL_MODE>",
        "SURF_RESEARCH_ROOT": "<YOUR_SURF_RESEARCH_ROOT>",
        "SURF_RESEARCH_VECTOR_MODEL": "<YOUR_SURF_RESEARCH_VECTOR_MODEL>",
        "SURF_RESEARCH_VECTOR_LOW_MEMORY": "<YOUR_SURF_RESEARCH_VECTOR_LOW_MEMORY>",
        "SURF_RESEARCH_VECTOR_THREADS": "<YOUR_SURF_RESEARCH_VECTOR_THREADS>",
        "SURF_RESEARCH_REPO_AUTO": "<YOUR_SURF_RESEARCH_REPO_AUTO>",
        "SURF_RESEARCH_REPO_AUTO_MAX_MB": "<YOUR_SURF_RESEARCH_REPO_AUTO_MAX_MB>",
        "SURF_RESEARCH_REPO_AUTO_MAX_FILES": "<YOUR_SURF_RESEARCH_REPO_AUTO_MAX_FILES>",
        "SURF_RESEARCH_BROKER_IDLE_MS": "<YOUR_SURF_RESEARCH_BROKER_IDLE_MS>",
        "SURF_RESEARCH_READ_CONCURRENCY": "<YOUR_SURF_RESEARCH_READ_CONCURRENCY>",
        "SURF_RESEARCH_QUERY_TIMEOUT_MS": "<YOUR_SURF_RESEARCH_QUERY_TIMEOUT_MS>",
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>",
        "SURF_LOCALE": "<YOUR_SURF_LOCALE>",
        "SURF_TZ": "<YOUR_SURF_TZ>",
        "SURF_HEADLESS": "<YOUR_SURF_HEADLESS>",
        "SURF_IDLE_CLOSE_MS": "<YOUR_SURF_IDLE_CLOSE_MS>",
        "SURF_ALLOW_PRIVATE": "<YOUR_SURF_ALLOW_PRIVATE>",
        "SURF_LLM_HEAL": "<YOUR_SURF_LLM_HEAL>",
        "SURF_LLM_PROVIDER": "<YOUR_SURF_LLM_PROVIDER>",
        "SURF_LLM_MODEL": "<YOUR_SURF_LLM_MODEL>",
        "ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
        "ORCAROUTER_API_KEY": "<YOUR_ORCAROUTER_API_KEY>"
      }
    }
  }
}

VS Code

Merge this local stdio configuration, replace every placeholder environment value, and restart VS Code. Koskamo has not executed this package.
VS Code configuration
{
  "servers": {
    "google-surf-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "google-surf-mcp@1.1.5"
      ],
      "env": {
        "SEARCH_API": "<YOUR_SEARCH_API>",
        "SURF_SEARCH_PROVIDER": "<YOUR_SURF_SEARCH_PROVIDER>",
        "SURF_SCHOLAR_PROVIDER": "<YOUR_SURF_SCHOLAR_PROVIDER>",
        "SURF_BROWSER_ENGINE": "<YOUR_SURF_BROWSER_ENGINE>",
        "CHROME_PATH": "<YOUR_CHROME_PATH>",
        "SURF_PROFILE_ROOT": "<YOUR_SURF_PROFILE_ROOT>",
        "SURF_RESEARCH": "<YOUR_SURF_RESEARCH>",
        "SURF_RETRIEVAL_MODE": "<YOUR_SURF_RETRIEVAL_MODE>",
        "SURF_RESEARCH_ROOT": "<YOUR_SURF_RESEARCH_ROOT>",
        "SURF_RESEARCH_VECTOR_MODEL": "<YOUR_SURF_RESEARCH_VECTOR_MODEL>",
        "SURF_RESEARCH_VECTOR_LOW_MEMORY": "<YOUR_SURF_RESEARCH_VECTOR_LOW_MEMORY>",
        "SURF_RESEARCH_VECTOR_THREADS": "<YOUR_SURF_RESEARCH_VECTOR_THREADS>",
        "SURF_RESEARCH_REPO_AUTO": "<YOUR_SURF_RESEARCH_REPO_AUTO>",
        "SURF_RESEARCH_REPO_AUTO_MAX_MB": "<YOUR_SURF_RESEARCH_REPO_AUTO_MAX_MB>",
        "SURF_RESEARCH_REPO_AUTO_MAX_FILES": "<YOUR_SURF_RESEARCH_REPO_AUTO_MAX_FILES>",
        "SURF_RESEARCH_BROKER_IDLE_MS": "<YOUR_SURF_RESEARCH_BROKER_IDLE_MS>",
        "SURF_RESEARCH_READ_CONCURRENCY": "<YOUR_SURF_RESEARCH_READ_CONCURRENCY>",
        "SURF_RESEARCH_QUERY_TIMEOUT_MS": "<YOUR_SURF_RESEARCH_QUERY_TIMEOUT_MS>",
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>",
        "SURF_LOCALE": "<YOUR_SURF_LOCALE>",
        "SURF_TZ": "<YOUR_SURF_TZ>",
        "SURF_HEADLESS": "<YOUR_SURF_HEADLESS>",
        "SURF_IDLE_CLOSE_MS": "<YOUR_SURF_IDLE_CLOSE_MS>",
        "SURF_ALLOW_PRIVATE": "<YOUR_SURF_ALLOW_PRIVATE>",
        "SURF_LLM_HEAL": "<YOUR_SURF_LLM_HEAL>",
        "SURF_LLM_PROVIDER": "<YOUR_SURF_LLM_PROVIDER>",
        "SURF_LLM_MODEL": "<YOUR_SURF_LLM_MODEL>",
        "ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
        "ORCAROUTER_API_KEY": "<YOUR_ORCAROUTER_API_KEY>"
      }
    }
  }
}

Claude Desktop

Merge this local stdio configuration, replace every placeholder environment value, and restart Claude Desktop. Koskamo has not executed this package.
Claude Desktop configuration
{
  "mcpServers": {
    "google-surf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "google-surf-mcp@1.1.5"
      ],
      "env": {
        "SEARCH_API": "<YOUR_SEARCH_API>",
        "SURF_SEARCH_PROVIDER": "<YOUR_SURF_SEARCH_PROVIDER>",
        "SURF_SCHOLAR_PROVIDER": "<YOUR_SURF_SCHOLAR_PROVIDER>",
        "SURF_BROWSER_ENGINE": "<YOUR_SURF_BROWSER_ENGINE>",
        "CHROME_PATH": "<YOUR_CHROME_PATH>",
        "SURF_PROFILE_ROOT": "<YOUR_SURF_PROFILE_ROOT>",
        "SURF_RESEARCH": "<YOUR_SURF_RESEARCH>",
        "SURF_RETRIEVAL_MODE": "<YOUR_SURF_RETRIEVAL_MODE>",
        "SURF_RESEARCH_ROOT": "<YOUR_SURF_RESEARCH_ROOT>",
        "SURF_RESEARCH_VECTOR_MODEL": "<YOUR_SURF_RESEARCH_VECTOR_MODEL>",
        "SURF_RESEARCH_VECTOR_LOW_MEMORY": "<YOUR_SURF_RESEARCH_VECTOR_LOW_MEMORY>",
        "SURF_RESEARCH_VECTOR_THREADS": "<YOUR_SURF_RESEARCH_VECTOR_THREADS>",
        "SURF_RESEARCH_REPO_AUTO": "<YOUR_SURF_RESEARCH_REPO_AUTO>",
        "SURF_RESEARCH_REPO_AUTO_MAX_MB": "<YOUR_SURF_RESEARCH_REPO_AUTO_MAX_MB>",
        "SURF_RESEARCH_REPO_AUTO_MAX_FILES": "<YOUR_SURF_RESEARCH_REPO_AUTO_MAX_FILES>",
        "SURF_RESEARCH_BROKER_IDLE_MS": "<YOUR_SURF_RESEARCH_BROKER_IDLE_MS>",
        "SURF_RESEARCH_READ_CONCURRENCY": "<YOUR_SURF_RESEARCH_READ_CONCURRENCY>",
        "SURF_RESEARCH_QUERY_TIMEOUT_MS": "<YOUR_SURF_RESEARCH_QUERY_TIMEOUT_MS>",
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>",
        "SURF_LOCALE": "<YOUR_SURF_LOCALE>",
        "SURF_TZ": "<YOUR_SURF_TZ>",
        "SURF_HEADLESS": "<YOUR_SURF_HEADLESS>",
        "SURF_IDLE_CLOSE_MS": "<YOUR_SURF_IDLE_CLOSE_MS>",
        "SURF_ALLOW_PRIVATE": "<YOUR_SURF_ALLOW_PRIVATE>",
        "SURF_LLM_HEAL": "<YOUR_SURF_LLM_HEAL>",
        "SURF_LLM_PROVIDER": "<YOUR_SURF_LLM_PROVIDER>",
        "SURF_LLM_MODEL": "<YOUR_SURF_LLM_MODEL>",
        "ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
        "ORCAROUTER_API_KEY": "<YOUR_ORCAROUTER_API_KEY>"
      }
    }
  }
}

Let your agent find its tools

Find servers like google-surf-mcp from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 7,452