Google Surf MCP

Name: Google Surf MCP
Author: HarimxChoi

de HarimxChoiversión 1.1.6i★ –iSe ejecuta en tu computadora

Nombre en el registroio.github.HarimxChoi/google-surf-mcp

Instalar

Resumen

Descripción del creador (original en inglés)

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

Los tres pilares de PopNx MCP

Estos tres nunca se combinan en una sola puntuación: las opiniones, las mediciones y la popularidad son cosas distintas.

Opinión de usuariosiAún no hay reseñasLas reseñas se abrirán junto con las cuentas en una etapa posterior
Nuestras revisiones básicasi1 de 1 superadasRevisado con información pública; el código aún no se ha escaneado
UsoiInicial↓ 361/sem · ★ –

Qué puedes hacer con él

Todavía no escribimos un resumen sencillo para este. Abajo están los datos que leímos del registro.

Conexión: Se ejecuta en tu computadora
Transporte: stdio
Categoría: Búsqueda y memoria de IA
Debes completar: SEARCH_API, GITHUB_TOKEN, ANTHROPIC_API_KEY, ORCAROUTER_API_KEY

Instalación

Elige la app de IA que usas y copia la configuración.

Antes de instalar

Revisiones básicas: 1 de 1 superadas
Se ejecuta en tu computadora con los permisos de tu usuario (archivos, red, apps).
Debes completar tú: SEARCH_API, SURF_SEARCH_PROVIDER, SURF_SCHOLAR_PROVIDER, SURF_BROWSER_ENGINE, CHROME_PATH, SURF_PROFILE_ROOT, SURF_RESEARCH, SURF_RETRIEVAL_MODE, SURF_RESEARCH_ROOT, SURF_RESEARCH_VECTOR_MODEL, SURF_RESEARCH_VECTOR_LOW_MEMORY, SURF_RESEARCH_VECTOR_THREADS, SURF_RESEARCH_REPO_AUTO, SURF_RESEARCH_REPO_AUTO_MAX_MB, SURF_RESEARCH_REPO_AUTO_MAX_FILES, SURF_RESEARCH_BROKER_IDLE_MS, SURF_RESEARCH_READ_CONCURRENCY, SURF_RESEARCH_QUERY_TIMEOUT_MS, GITHUB_TOKEN, SURF_LOCALE, SURF_TZ, SURF_HEADLESS, SURF_IDLE_CLOSE_MS, SURF_ALLOW_PRIVATE, SURF_LLM_HEAL, SURF_LLM_PROVIDER, SURF_LLM_MODEL, ANTHROPIC_API_KEY, ORCAROUTER_API_KEY

Los valores marcados como secretos son llaves de tu cuenta. Nunca los compartas ni los pegues en un chat.

Necesitas

npmNode.js instalado (para el comando npx)

¿Qué app usas?

ClaudeClaude CodeCursorVS CodeChatGPT

Elige tu app arriba. La recordamos, así que la próxima vez el botón dirá “Instalar en …”.

Abre Claude Desktop → Settings → Developer → Edit Config y pega esto en claude_desktop_config.json

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

Ejecuta esto en tu terminal

claude mcp add google-surf --env SEARCH_API=your-value --env SURF_SEARCH_PROVIDER=your-value --env SURF_SCHOLAR_PROVIDER=your-value --env SURF_BROWSER_ENGINE=your-value --env CHROME_PATH=your-value --env SURF_PROFILE_ROOT=your-value --env SURF_RESEARCH=your-value --env SURF_RETRIEVAL_MODE=your-value --env SURF_RESEARCH_ROOT=your-value --env SURF_RESEARCH_VECTOR_MODEL=your-value --env SURF_RESEARCH_VECTOR_LOW_MEMORY=your-value --env SURF_RESEARCH_VECTOR_THREADS=your-value --env SURF_RESEARCH_REPO_AUTO=your-value --env SURF_RESEARCH_REPO_AUTO_MAX_MB=your-value --env SURF_RESEARCH_REPO_AUTO_MAX_FILES=your-value --env SURF_RESEARCH_BROKER_IDLE_MS=your-value --env SURF_RESEARCH_READ_CONCURRENCY=your-value --env SURF_RESEARCH_QUERY_TIMEOUT_MS=your-value --env GITHUB_TOKEN=your-value --env SURF_LOCALE=your-value --env SURF_TZ=your-value --env SURF_HEADLESS=your-value --env SURF_IDLE_CLOSE_MS=your-value --env SURF_ALLOW_PRIVATE=your-value --env SURF_LLM_HEAL=your-value --env SURF_LLM_PROVIDER=your-value --env SURF_LLM_MODEL=your-value --env ANTHROPIC_API_KEY=your-value --env ORCAROUTER_API_KEY=your-value -- npx -y google-surf-mcp

Completa los valores vacíos antes de ejecutarlo.

Abrir en Cursor

O copia la configuración tú

Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.cursor/mcp.json

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

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Abrir en VS Code

O copia la configuración tú

Pégalo en .vscode/mcp.json de tu proyecto

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

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Este se ejecuta en tu computadora, y ChatGPT solo puede conectarse a servidores en internet. Elige otra app.

Tu elección se guarda en una cookie en este dispositivo; no necesitas cuenta.

Valores que debes completar

SEARCH_API secreto env
SearchApi API key. Required only for SearchApi primary or fallback modes.
SURF_SEARCH_PROVIDER env
Provider for search and search_parallel: browser, searchapi, or fallback. Defaults to browser.
SURF_SCHOLAR_PROVIDER env
Provider for scholar_search: browser, searchapi, or fallback. Defaults to browser.
SURF_BROWSER_ENGINE env
Browser engine: auto, native, or playwright. Auto uses one hidden native Chrome broker shared across local MCP sessions.
CHROME_PATH env
Absolute path to the Chrome binary. Auto-detected on Windows/macOS/Linux when omitted.
SURF_PROFILE_ROOT env
Directory for the warm Chrome profile. Defaults to ~/.google-surf-mcp.
SURF_RESEARCH env
Enable Google Surf Auto Ontology: local project memory, evidence capture, and hybrid retrieval. Defaults to true. The SURF_RESEARCH setting name is unchanged.
SURF_RETRIEVAL_MODE env
Shared route for search and search_parallel: live or hybrid. Defaults to hybrid.
SURF_RESEARCH_ROOT env
Embedded SurrealDB data directory. Defaults to /research.
SURF_RESEARCH_VECTOR_MODEL env
Local model for HNSW retrieval and shared reranking. Defaults to Xenova/multilingual-e5-small; use off to disable.
SURF_RESEARCH_VECTOR_LOW_MEMORY env
Disable ONNX CPU memory arena and memory pattern. Defaults to true.
SURF_RESEARCH_VECTOR_THREADS env
ONNX intra-op thread count from 1 to 16. Defaults to 4.
SURF_RESEARCH_REPO_AUTO env
Sparse-index at most one eligible small GitHub repository per search call. Defaults to true.
SURF_RESEARCH_REPO_AUTO_MAX_MB env
Maximum searchable repository source-text size in MB. Assets are excluded. Defaults to 20.
SURF_RESEARCH_REPO_AUTO_MAX_FILES env
Maximum repository source file count for automatic indexing. Defaults to 2000.
SURF_RESEARCH_BROKER_IDLE_MS env
Shared Auto Ontology broker idle lifetime in milliseconds. Defaults to 60000.
SURF_RESEARCH_READ_CONCURRENCY env
Maximum concurrent Auto Ontology broker reads. Defaults to 4.
SURF_RESEARCH_QUERY_TIMEOUT_MS env
Timeout per embedded SurrealDB query in milliseconds. Defaults to 120000; timed-out retrieval lanes are reported as partial.
GITHUB_TOKEN secreto env
Optional token that raises GitHub API limits for repository inspection.
SURF_LOCALE env
Browser locale, e.g. en-US.
SURF_TZ env
IANA timezone, e.g. America/New_York. Defaults to system timezone.
SURF_HEADLESS env
Controls Playwright extraction, compatibility, and recovery paths. Native search hides normal system Chrome and shows it only for CAPTCHA recovery.
SURF_IDLE_CLOSE_MS env
Idle ms before closing the sequential ctx and pool. 0 disables idle auto-close. Defaults to 30000.
SURF_ALLOW_PRIVATE env
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.
SURF_LLM_HEAL env
Enable the optional workflow-only LLM selector repair path. Defaults to false.
SURF_LLM_PROVIDER env
LLM selector repair provider: anthropic or orcarouter. Defaults to anthropic.
SURF_LLM_MODEL env
Optional model override. OrcaRouter defaults to orcarouter/auto.
ANTHROPIC_API_KEY secreto env
Anthropic API key for optional LLM-assisted selector repair.
ORCAROUTER_API_KEY secreto env
OrcaRouter API key for optional LLM-assisted selector repair.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 8 nov 2026

✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub HarimxChoi, dueña del repo
… Aún sin revisar
Sigue en mantenimiento
Todavía no hemos leído este repo en GitHub
… Aún sin revisar
Tiene licencia
Todavía no hemos leído este repo en GitHub
– No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
– No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
… Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Comparado con otros en Búsqueda y memoria de IAi

Más estrellas que el 0% de los otros 5684 servidores de esta categoría
Publicado en el registro más recientemente que el 98% de los otros 5684 servidores de esta categoría
Revisiones básicas iguales o mejores que el 100% de los otros 5684 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Google Surf MCP?

Superó 1 de 1 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: SEARCH_API, GITHUB_TOKEN, ANTHROPIC_API_KEY, ORCAROUTER_API_KEY

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez –, y la última versión (1.1.6) llegó al registro ayer.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: Context7, Codebase Memory, Exa

Alternativas

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Context7

Up-to-date docs for AI agents

de upstashMuy usado↓ 972,7 mil/sem★ 64,2 milActualizado anteayer

Computadora o nube

Instalar

Codebase Memory

Codebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens.

de DeusDataMuy usado↓ 18 mil/sem★ 48,1 milActualizado hace 22 días

Se ejecuta en tu computadora

Instalar

Exa

Connect AI agents to Exa for web search, content fetching, and multi-step research.

de exa-labsEn crecimiento★ 5,2 milActualizado hace 2 meses

Se ejecuta en la nube✓ exa.ai

Instalar

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

google-surf-mcp

English | Korean

Google Surf MCP searches the web, papers, and codebases, then uses Auto Ontology to organize what you read into a local knowledge graph. Start without an API key or a separate database server, and build a personal knowledge base from connected sources and project records.

Core features

Search and read: Find web pages, papers, PDFs, GitHub repositories, and indexed local code. Tree-sitter links files, code symbols, imports, and function calls.
Auto Ontology: Organize sources and project records into a typed knowledge graph with evidence and data lineage.
Cross-project search: Find stored sources across selected projects using exact-match, keyword, semantic, and graph retrieval, with RRF fusion and a shared reranker.
Explore and export: Browse PKM, lineage, and ontology views; export HTML, PNG, JSON, Graphviz DOT, and Neo4j import bundles.

Stack: TypeScript, Chrome/Playwright, LiteParse, Tree-sitter, SurrealDB, Multilingual E5, and Graphology. Architecture

Quick start

Requires Node.js 22.12+ and Chrome or Chromium for browser search. CI covers Node 22 and 24 on Linux and Windows.

"mcpServers": { "google-surf": { "command": "npx", "args": ["-y", "google-surf-mcp@latest"] } } }

Restart the client. Auto Ontology is enabled by default; the local embedding model may be downloaded when you first index content. For search and extraction without the database or embedding model, set SURF_RESEARCH=false in the server environment.

Client setup, local installation, and SearchApi configuration

Search

Search through system Chrome without an API key
Dedicated logged-out profile; your personal Chrome profile is never read or copied
Multi-strategy SERP parsing with geometric verification
Removal of sponsored results and knowledge panels
CAPTCHA detection and environment-specific recovery
Parser self-healing and context fallback

Browser search is the default. SearchApi is an optional primary provider or fallback; it requires your own account, key, and credits.

Supported AI providers and gateways

OrcaRouter (free models available)

Optional LLM-assisted repair and OrcaRouter setup

Tools

Seven tools are available with Auto Ontology enabled:

Tool	Use
`search` / `search_parallel`	Discover new web sources and read them in the same call with `extract_mode`.
`scholar_search`	Find paper-specific Google Scholar metadata.
`extract`	Read a web page, PDF, or repository from an already-known URL.
`project_memory_search`	Local-only search of indexed project knowledge; no live web search.
`project_memory`	Manage projects, save research records, index user-approved local folders, and export graphs.
`health`	Inspect search and local runtime status.

Providing project_id to web search does not make it local-only. Use project_memory_search for stored knowledge.

Tool parameters, limits, follow-up reads, and repeatable source collection

Google Surf Auto Ontology

Search and extraction results are saved automatically. Plans, experiments, failures, and decisions are linked when your agent records them through project_memory.

Web + papers + code + project records

| Local knowledge graph | Hybrid retrieval + source-backed evidence

Projects stay separate by default. Selected projects can link knowledge using matching DOIs, repository URLs, or explicitly registered aliases; original records are not merged or moved.

Create a standalone graph explorer for one project:

project_memory(action="export", project_id="my-project", export_format="html", export_view="graph")

The HTML explorer includes PKM, lineage, and ontology views with PNG/JSON downloads. DOT and Neo4j exports are also available. The feature was renamed from Research to Auto Ontology; existing SURF_RESEARCH* settings, project_memory* tools, CLI names, and storage paths still work.

Ontology, lineage, code indexing, and export details

Benchmark

Live web result ranking on 32 held-out queries:

Ranking	nDCG@5	MRR	Precision@5
Original provider ranking	0.8949	0.8203	0.6375
BM25 + RRF	0.8971	0.8203	0.6500

Evaluation conditions, retrieval results, and resource measurements

Documentation

Guide	Contents
Getting started	Installation, clients, browser search, SearchApi setup
Tools and workflows	Tool parameters, limits, evidence responses, source collection
Auto Ontology	Storage, code structure, graph retrieval, lineage, exports
Configuration	Environment variables, resource settings, OrcaRouter
Operations and security	CAPTCHA, cache cleanup, CLI, privacy, optional Codex hooks
Benchmarks	Measurements, conditions, and evaluation boundaries

Contributing · Changelog · MIT License

Google Surf MCP

Resumen

Los tres pilares de PopNx MCP

Qué puedes hacer con él

Instalación

Antes de instalar

Valores que debes completar

Qué puede hacer

Revisiones básicasi

El creador coincide con el repo

Sigue en mantenimiento

Tiene licencia

El endpoint responde

Inicio de sesión con OAuth

Sin instrucciones ocultas en las descripciones de herramientas

Comparado con otros en Búsqueda y memoria de IAi

Preguntas frecuentes

Alternativas

Context7

Codebase Memory

Exa

README del creador

google-surf-mcp

Core features

Quick start

Search

Supported AI providers and gateways

Tools

Google Surf Auto Ontology

Benchmark

Documentation