Search / io.github.HarimxChoi/google-surf-mcp
protogridL0· runs locallyWeb, academic and code search with graph RAG, data lineage, ontology and cross-project schema links.
v1.1.4 · active · repository · descriptor JSON · versions
{
"mcpServers": {
"google-surf-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"SEARCH_API": "${SEARCH_API}",
"GITHUB_TOKEN": "${GITHUB_TOKEN}",
"ANTHROPIC_API_KEY": "${ANTHROPIC_API_KEY}",
"ORCAROUTER_API_KEY": "${ORCAROUTER_API_KEY}"
}
}
}
}claude mcp add google-surf-mcp -e "SEARCH_API=${SEARCH_API}" -e "GITHUB_TOKEN=${GITHUB_TOKEN}" -e "ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}" -e "ORCAROUTER_API_KEY=${ORCAROUTER_API_KEY}" -- npx -y [email protected][mcp_servers.google-surf-mcp]
command = "npx"
args = ["-y", "[email protected]"]
env = { "SEARCH_API" = "${SEARCH_API}", "GITHUB_TOKEN" = "${GITHUB_TOKEN}", "ANTHROPIC_API_KEY" = "${ANTHROPIC_API_KEY}", "ORCAROUTER_API_KEY" = "${ORCAROUTER_API_KEY}" }
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"google-surf-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"[email protected]"
],
"enabled": true,
"environment": {
"SEARCH_API": "{env:SEARCH_API}",
"GITHUB_TOKEN": "{env:GITHUB_TOKEN}",
"ANTHROPIC_API_KEY": "{env:ANTHROPIC_API_KEY}",
"ORCAROUTER_API_KEY": "{env:ORCAROUTER_API_KEY}"
}
}
}
}{
"mcpServers": {
"google-surf-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"SEARCH_API": "${SEARCH_API}",
"GITHUB_TOKEN": "${GITHUB_TOKEN}",
"ANTHROPIC_API_KEY": "${ANTHROPIC_API_KEY}",
"ORCAROUTER_API_KEY": "${ORCAROUTER_API_KEY}"
}
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=google-surf-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImdvb2dsZS1zdXJmLW1jcEAxLjEuNCJdLCJlbnYiOnsiU0VBUkNIX0FQSSI6IiR7U0VBUkNIX0FQSX0iLCJHSVRIVUJfVE9LRU4iOiIke0dJVEhVQl9UT0tFTn0iLCJBTlRIUk9QSUNfQVBJX0tFWSI6IiR7QU5USFJPUElDX0FQSV9LRVl9IiwiT1JDQVJPVVRFUl9BUElfS0VZIjoiJHtPUkNBUk9VVEVSX0FQSV9LRVl9In19"
}{
"servers": {
"google-surf-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"SEARCH_API": "${SEARCH_API}",
"GITHUB_TOKEN": "${GITHUB_TOKEN}",
"ANTHROPIC_API_KEY": "${ANTHROPIC_API_KEY}",
"ORCAROUTER_API_KEY": "${ORCAROUTER_API_KEY}"
}
}
}
}{
"mcpServers": {
"google-surf-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"SEARCH_API": "${SEARCH_API}",
"GITHUB_TOKEN": "${GITHUB_TOKEN}",
"ANTHROPIC_API_KEY": "${ANTHROPIC_API_KEY}",
"ORCAROUTER_API_KEY": "${ORCAROUTER_API_KEY}"
}
}
}
}extensions:
"google-surf-mcp":
enabled: true
name: "google-surf-mcp"
type: stdio
cmd: "npx"
args:
- "-y"
- "[email protected]"
envs:
"SEARCH_API": "${SEARCH_API}"
"GITHUB_TOKEN": "${GITHUB_TOKEN}"
"ANTHROPIC_API_KEY": "${ANTHROPIC_API_KEY}"
"ORCAROUTER_API_KEY": "${ORCAROUTER_API_KEY}"
timeout: 300
Placeholders to fill from your own secret store: ${SEARCH_API}, ${GITHUB_TOKEN}, ${ANTHROPIC_API_KEY}, ${ORCAROUTER_API_KEY}. The registry never accepts secret values.
This is a local package: the command runs on your machine.
Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.
protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlno remote answered a protocol handshake (not probed yet, unreachable, or local-only)auth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptions, tools.description_length, tools.schemas, tools.annotations, tools.directory_hints, tools.token_cost, tools.api_dumptool list unknown (behind auth, not probed, or empty)stability.changes, stability.rug_pulltool list unknowndeps.known_vulns, deps.mcp_sdk_version, deps.resolvabledependencies not resolved yetNo tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+repository +namespace-matches-repo ~liveness-unmeasured +updated-1d-ago
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
[email protected] npmnot resolved yet; dependencies are read once a day
Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.
| package | registry | version | runtime | secrets |
|---|---|---|---|---|
google-surf-mcp | npm | 1.1.4 | – | SEARCH_API, GITHUB_TOKEN, ANTHROPIC_API_KEY, ORCAROUTER_API_KEY |
No tools observed. Local packages are never executed by the registry.
Schemas: list_tools.
{
"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."
}