Google Surf MCP

Name: Google Surf MCP
Author: HarimxChoi

โดย HarimxChoiรุ่น 1.1.6i★ –iรันบนเครื่อง

ชื่อใน registryio.github.HarimxChoi/google-surf-mcp

ติดตั้ง

ภาพรวม

คำอธิบายจากผู้ทำ (ภาษาอังกฤษตามต้นฉบับ)

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

สามเสาของ PopNx MCP

สามเรื่องนี้ไม่รวมเป็นคะแนนเดียว เพราะความเห็น การวัด และความนิยม เป็นคนละเรื่องกัน

เสียงผู้ใช้iยังไม่มีรีวิวรีวิวเปิดพร้อมระบบบัญชีในขั้นถัดไป
ผลตรวจเบื้องต้นของเราiผ่าน 1 จาก 1 ข้อตรวจจากข้อมูลที่เปิดอยู่ ยังไม่ได้สแกนโค้ด
การใช้งานiยังไม่ได้วัด★ –

ใช้ทำอะไรได้

ตัวนี้ยังไม่ได้เรียบเรียงเป็นภาษาไทย ด้านล่างคือข้อเท็จจริงที่เราอ่านจาก registry

การเชื่อมต่อ: รันบนเครื่อง
ช่องทาง (transport): stdio
หมวด: ค้นข้อมูลและความจำของ AI
ต้องใส่ค่าเหล่านี้: SEARCH_API, GITHUB_TOKEN, ANTHROPIC_API_KEY, ORCAROUTER_API_KEY

ติดตั้ง

เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง

ก่อนติดตั้ง

ผลตรวจเบื้องต้น: ผ่าน 1 จาก 1 ข้อ
รันในเครื่องคุณด้วยสิทธิ์ของผู้ใช้คุณ (ไฟล์ อินเทอร์เน็ต แอปต่าง ๆ)
ค่าที่คุณต้องใส่เอง: 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

ค่าที่ติดป้ายความลับคือกุญแจของบัญชีคุณ อย่าส่งให้ใคร และอย่าวางในแชต

ต้องเตรียมก่อน

npmติดตั้ง Node.js (มีคำสั่ง npx) ในเครื่อง

คุณใช้แอปไหน

ClaudeClaude CodeCursorVS CodeChatGPT

เลือกแอปด้านบน เราจำไว้ให้ ครั้งหน้าปุ่มจะขึ้นว่า “ติดตั้งลง …”

เปิด Claude Desktop → Settings → Developer → Edit Config แล้ววางค่านี้ในไฟล์ claude_desktop_config.json

{
  "mcpServers": {
    "google-surf": {
      "command": "npx",
      "args": [
        "-y",
        "google-surf-mcp"
      ],
      "env": {
        "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": "ใส่ค่าของคุณ"
      }
    }
  }
}

พิมพ์คำสั่งนี้ใน Terminal

claude mcp add google-surf --env SEARCH_API='ใส่ค่าของคุณ' --env SURF_SEARCH_PROVIDER='ใส่ค่าของคุณ' --env SURF_SCHOLAR_PROVIDER='ใส่ค่าของคุณ' --env SURF_BROWSER_ENGINE='ใส่ค่าของคุณ' --env CHROME_PATH='ใส่ค่าของคุณ' --env SURF_PROFILE_ROOT='ใส่ค่าของคุณ' --env SURF_RESEARCH='ใส่ค่าของคุณ' --env SURF_RETRIEVAL_MODE='ใส่ค่าของคุณ' --env SURF_RESEARCH_ROOT='ใส่ค่าของคุณ' --env SURF_RESEARCH_VECTOR_MODEL='ใส่ค่าของคุณ' --env SURF_RESEARCH_VECTOR_LOW_MEMORY='ใส่ค่าของคุณ' --env SURF_RESEARCH_VECTOR_THREADS='ใส่ค่าของคุณ' --env SURF_RESEARCH_REPO_AUTO='ใส่ค่าของคุณ' --env SURF_RESEARCH_REPO_AUTO_MAX_MB='ใส่ค่าของคุณ' --env SURF_RESEARCH_REPO_AUTO_MAX_FILES='ใส่ค่าของคุณ' --env SURF_RESEARCH_BROKER_IDLE_MS='ใส่ค่าของคุณ' --env SURF_RESEARCH_READ_CONCURRENCY='ใส่ค่าของคุณ' --env SURF_RESEARCH_QUERY_TIMEOUT_MS='ใส่ค่าของคุณ' --env GITHUB_TOKEN='ใส่ค่าของคุณ' --env SURF_LOCALE='ใส่ค่าของคุณ' --env SURF_TZ='ใส่ค่าของคุณ' --env SURF_HEADLESS='ใส่ค่าของคุณ' --env SURF_IDLE_CLOSE_MS='ใส่ค่าของคุณ' --env SURF_ALLOW_PRIVATE='ใส่ค่าของคุณ' --env SURF_LLM_HEAL='ใส่ค่าของคุณ' --env SURF_LLM_PROVIDER='ใส่ค่าของคุณ' --env SURF_LLM_MODEL='ใส่ค่าของคุณ' --env ANTHROPIC_API_KEY='ใส่ค่าของคุณ' --env ORCAROUTER_API_KEY='ใส่ค่าของคุณ' -- npx -y google-surf-mcp

เติมค่าที่เว้นว่างไว้ก่อนรัน

เปิดใน Cursor

หรือคัดลอกค่าตั้งเอง

วางในไฟล์ .cursor/mcp.json ของโปรเจกต์ หรือ ~/.cursor/mcp.json

{
  "mcpServers": {
    "google-surf": {
      "command": "npx",
      "args": [
        "-y",
        "google-surf-mcp"
      ],
      "env": {
        "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": "ใส่ค่าของคุณ"
      }
    }
  }
}

เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง

เปิดใน VS Code

หรือคัดลอกค่าตั้งเอง

วางในไฟล์ .vscode/mcp.json ของโปรเจกต์

{
  "servers": {
    "google-surf": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "google-surf-mcp"
      ],
      "env": {
        "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": "ใส่ค่าของคุณ"
      }
    }
  }
}

ตัวนี้รันในเครื่องคุณ แต่ ChatGPT ต่อได้เฉพาะ server บนอินเทอร์เน็ต ลองเลือกแอปอื่น

ตัวเลือกเก็บในคุกกี้บนเครื่องนี้ ไม่ต้องมีบัญชี

ค่าที่ต้องใส่เอง

SEARCH_API ความลับ 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 ความลับ 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 ความลับ env
Anthropic API key for optional LLM-assisted selector repair.
ORCAROUTER_API_KEY ความลับ env
OrcaRouter API key for optional LLM-assisted selector repair.

ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README

ทำอะไรได้บ้าง

รันในเครื่องคุณ รายการเครื่องมือจะขึ้นในแอป AI หลังติดตั้ง

ผลตรวจเบื้องต้นi

เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 7 พ.ย. 2569

✓ ผ่าน
ตัวตนผู้ทำตรงกับ repo
ชื่อใน registry ยืนยันด้วยบัญชี GitHub HarimxChoi ซึ่งเป็นเจ้าของ repo
… ยังไม่ตรวจ
ยังมีคนดูแล
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
… ยังไม่ตรวจ
มีสัญญาอนุญาต (license)
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
– ไม่เกี่ยว
endpoint ตอบ
ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต
– ไม่เกี่ยว
ล็อกอินแบบ OAuth
ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน
… ยังไม่ตรวจ
คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง
รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต

เทียบกับตัวอื่นในหมวด ค้นข้อมูลและความจำของ AIi

ดาวมากกว่า 0% ของอีก 5662 ตัวในหมวดนี้
ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 99% ของอีก 5662 ตัวในหมวดนี้
ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 100% ของอีก 5662 ตัวในหมวดนี้

เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo

คำถามที่พบบ่อย

Google Surf MCP ปลอดภัยไหม?

จากการตรวจเบื้องต้นของเรา ผ่าน 1 จาก 1 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น

ต้องใช้กุญแจหรือรหัสอะไรบ้าง?

ต้องใส่ค่าเหล่านี้: SEARCH_API, GITHUB_TOKEN, ANTHROPIC_API_KEY, ORCAROUTER_API_KEY

ตัวนี้รันบนเครื่องหรือบนคลาวด์?

รันบนเครื่องของคุณ โปรแกรม AI จะเปิด server ขึ้นมาเองเมื่อใช้ ข้อมูลไม่ต้องผ่านเซิร์ฟเวอร์ของผู้ทำ (ยกเว้นตัวที่ไปเรียกบริการออนไลน์ต่อ)

ยังมีคนดูแลอยู่ไหม?

repo บน GitHub มีการแก้โค้ดล่าสุด – และส่งรุ่นล่าสุด (1.1.6) เข้า registry วันนี้

ใช้กับโปรแกรมไหนได้บ้าง?

โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต้องมี Node.js ในเครื่องด้วย

มีตัวไหนใช้แทนได้บ้าง?

ในหมวดเดียวกันมี Context7, Codebase Memory, Exa

ตัวที่ใช้แทนได้

server หมวดเดียวกันจากผู้ทำคนอื่น เรียงตามดาว

อ่านการ์ด:★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi

Context7

โดย upstash

ส่งคู่มือการใช้ไลบรารีและเฟรมเวิร์กรุ่นล่าสุดให้ AI อ่านก่อนตอบ ช่วยให้โค้ดที่ AI เขียนไม่ใช้คำสั่งเก่าที่เลิกใช้แล้ว

บนเครื่องหรือคลาวด์★ 64,224MITอัปเดต เมื่อวาน

ติดตั้ง

Codebase Memory

โดย DeusData

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

รันบนเครื่อง★ 48,148MITอัปเดต 21 วันที่ผ่านมา

ติดตั้ง

Exa

โดย exa-labs

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

รันบนคลาวด์★ 5,213MITอัปเดต 2 เดือนที่ผ่านมา

ติดตั้ง

README จากผู้ทำ

เปิดอ่าน README

ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ

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

ภาพรวม

สามเสาของ PopNx MCP

ใช้ทำอะไรได้

ติดตั้ง

ก่อนติดตั้ง

ค่าที่ต้องใส่เอง

ทำอะไรได้บ้าง

ผลตรวจเบื้องต้นi

ตัวตนผู้ทำตรงกับ repo

ยังมีคนดูแล

มีสัญญาอนุญาต (license)

endpoint ตอบ

ล็อกอินแบบ OAuth

คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง

เทียบกับตัวอื่นในหมวด ค้นข้อมูลและความจำของ AIi

คำถามที่พบบ่อย

ตัวที่ใช้แทนได้

Context7

Codebase Memory

Exa

README จากผู้ทำ

google-surf-mcp

Core features

Quick start

Search

Supported AI providers and gateways

Tools

Google Surf Auto Ontology

Benchmark

Documentation