google-surf-mcp 是什么工具？

google-surf-mcp 是一款TypeScript开发的AI辅助工具。开源MCP工具：Google search MCP. No API key. One MCP replaces search + fetch + academic-paper 。⭐173 · TypeScript 主要应用场景包括：MCP配置。

google-surf-mcp 如何安装和开始使用？

访问 google-surf-mcp 的 GitHub 仓库或官方网站，按照 README 文档中的步骤安装依赖并运行。通常需要 Python 3.8+ 或 Node.js 16+ 基础环境。

google-surf-mcp 是否免费？许可证是什么？

google-surf-mcp 完全免费，采用 MIT 许可证开源发布，任何人都可以免费使用、修改和分发。

google-surf-mcp 适合哪些用户使用？

google-surf-mcp 主要面向有一定技术基础的用户，包括开发者、数据分析师、AI 工程师等专业人士。

google-surf-mcp 的社区活跃度和项目维护状况如何？

google-surf-mcp 在 GitHub 上已获得 173 个 Star，处于积极发展阶段，社区在持续扩大。

📄 工具详情 ⚙️ 安装教程 📚 使用教程

能力标签

🔌 MCP 🔄 工作流 🧠 Claude

🔌

MCP工具

google-surf-mcp MCP工具

基于 TypeScript · 让 AI 助手直接操作你的系统与工具

英文名：google-surf-mcp

⭐ 173 Stars 🍴 24 Forks 💻 TypeScript 📄 MIT 🏷 AI 8.2分

8.2AI 综合评分

Google搜索MCP协议无需密钥网页抓取学术论文

⬇ 下载源码 ZIP ⚙️ 配置说明

✦ AI Skill Hub 推荐

AI Skill Hub 强烈推荐：google-surf-mcp MCP工具是一款优质的MCP工具。AI 综合评分 8.2 分，在同类工具中表现稳健。如果你正在寻找可靠的MCP工具解决方案，这是一个值得深入了解的选择。

📚 深度解析

google-surf-mcp MCP工具是一款基于 MCP（Model Context Protocol）标准协议的 AI 工具扩展。MCP 协议由 Anthropic 开发并开源，旨在建立 AI 模型与外部工具之间的标准化通信接口，目前已被 Claude Desktop、Claude Code、Cursor 等主流 AI 工具采纳。

通过安装 google-surf-mcp MCP工具，你的 AI 助手将获得额外的工具调用能力，可以用自然语言直接操控该工具的功能，无需学习复杂的命令行语法。MCP 工具的核心价值在于"一次配置，永久增强"——配置完成后，每次与 AI 对话时都可以无缝调用这些工具。

在技术实现上，MCP 工具通过标准的 JSON-RPC 协议与 AI 客户端通信，工具的功能以"工具列表"的形式暴露给 AI 模型，AI 可以按需调用。google-surf-mcp MCP工具提供了结构化的工具调用接口，使 AI 模型能够精确地理解和使用每个功能点，显著降低 AI 在工具使用上的错误率。

与传统的 API 集成相比，MCP 工具的优势在于无需编写代码——用户只需在配置文件中添加几行 JSON，即可让 AI 获得全新能力。AI Skill Hub 将 google-surf-mcp MCP工具评为 AI 评分 8.2 分，属于同类工具中的优质选择。

📋 工具概览

无需API密钥的开源MCP工具，集成Google搜索、网页抓取和学术论文检索功能。一个MCP替代传统的搜索、获取和学术工具组合，适合需要集成搜索能力的Claude应用开发者。

google-surf-mcp MCP工具是一款遵循 MCP（Model Context Protocol）标准协议的 AI 工具扩展。通过 MCP 协议，它可以让 Claude、Cursor 等主流 AI 客户端直接访问和操作外部工具、数据源和服务，实现 AI 能力的无缝扩展。无论是文件操作、数据库查询还是 API 调用，都可以通过自然语言在 AI 对话中直接触发，极大提升生产效率。

GitHub Stars

⭐ 173

开发语言

TypeScript

支持平台

Windows / macOS / Linux

维护状态

轻量级项目，按需更新

开源协议

MIT

AI 综合评分

8.2 分

工具类型

MCP工具

Forks

📖 中文文档

以下内容由 AI Skill Hub 根据项目信息自动整理，如需查看完整原始文档请访问底部「原始来源」。

📌 核心特色

通过标准 MCP 协议与 Claude、Cursor 等主流 AI 客户端深度集成
提供结构化工具调用接口，显著降低 AI 集成复杂度
支持 Claude Desktop 和 Claude Code 无缝接入，开箱即用
可与其他 MCP 工具组合叠加，构建完整 AI 工作站
轻量无侵入设计，不影响现有系统架构

🎯 主要使用场景

在 Claude Desktop 对话中直接调用本地工具，实现 AI 与系统的深度联动
通过自然语言驱动复杂的多步骤自动化任务，代替繁琐手动操作
将多个 MCP 工具组合使用，构建个人专属 AI 工作站

以下安装命令基于项目开发语言和类型自动生成，实际以官方 README 为准。

安装命令

# 方式一：通过 Claude Code CLI 一键安装
claude skill install https://github.com/HarimxChoi/google-surf-mcp

# 方式二：手动配置 claude_desktop_config.json
{
  "mcpServers": {
    "google-surf-mcp-mcp--": {
      "command": "npx",
      "args": ["-y", "google-surf-mcp"]
    }
  }
}

# 配置文件位置
# macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
# Windows: %APPDATA%/Claude/claude_desktop_config.json

📋 安装步骤说明

确认已安装 Node.js（v18 或以上版本）
打开 Claude Desktop 或 Claude Code 的 MCP 配置文件
按「交给 Agent 安装 → Claude Desktop」标签中的 JSON 配置填入 mcpServers 字段
保存配置文件并重启 Claude 客户端
重启后，在对话中即可使用本工具

以下用法示例由 AI Skill Hub 整理，涵盖最常见的使用场景。

常用命令 / 代码示例

# 安装后在 Claude 对话中直接使用
# 示例：
用户: 请帮我用 google-surf-mcp MCP工具 执行以下任务...
Claude: [自动调用 google-surf-mcp MCP工具 MCP 工具处理请求]

# 查看可用工具列表
# 在 Claude 中输入："列出所有可用的 MCP 工具"

以下配置示例基于典型使用场景生成，具体参数请参照官方文档调整。

配置示例

// claude_desktop_config.json 配置示例
{
  "mcpServers": {
    "google-surf-mcp_mcp__": {
      "command": "npx",
      "args": ["-y", "google-surf-mcp"],
      "env": {
        // "API_KEY": "your-api-key-here"
      }
    }
  }
}

// 保存后重启 Claude Desktop 生效

📑 README 深度解析真实文档完整度 40/100 查看 GitHub 原文 →

以下内容由系统直接从 GitHub README 解析整理，保留代码块、表格与列表结构。

简介

Install

Requires Node 18+ and Google Chrome (or Chromium) on the system.

npx google-surf-mcp   # actual MCP - register in client config

First tool call auto-bootstraps the warm profile (you may see Chrome open briefly).

Or local clone:

git clone https://github.com/HarimxChoi/google-surf-mcp
cd google-surf-mcp
npm install

If auto-bootstrap fails (rare), run it manually:

npm run bootstrap

Override paths if needed:

CHROME_PATH=/path/to/chrome SURF_TZ=America/New_York npm run bootstrap

Env vars

var	default	notes
`CHROME_PATH`	auto-detected	absolute path to Chrome binary
`SURF_PROFILE_ROOT`	`~/.google-surf-mcp`	where the warm profile lives
`SURF_LOCALE`	`en-US`	browser locale
`SURF_TZ`	system tz	e.g. `America/New_York`
`SURF_HEADLESS`	`true`	set `false` to run Chrome visibly (demos / debugging). When `false`, CAPTCHA recovery skips the OS notification (user is already watching).
`SURF_REMOTE_DEBUG`	`false`	set `true` on a headless server with remote DevTools. CAPTCHA path emits the DevTools port and throws instead of spawning a window; attach `chrome://inspect` from a local machine over SSH port-forward to solve.
`SURF_IDLE_CLOSE_MS`	`30000`	idle ms before closing the sequential ctx and pool. `0` disables idle auto-close. Lower = faster cleanup, higher = warmer cache for spaced-out calls.
`SURF_ALLOW_PRIVATE`	`false`	set `true` to allow `extract` to fetch private/loopback addresses (`localhost`, `127.0.0.1`, `10.x`, `192.168.x`, `169.254.x`, etc). Default blocks them as an SSRF guard.
`SURF_CLOUD_MODE`	`false`	headless/serverless mode: TLS bypass + `--no-sandbox` + `--disable-dev-shm-usage` + worker pool disabled + fail-fast on CAPTCHA
`SURF_CASCADE_DISABLED`	`false`	pin a single stealth mode (chosen by `SURF_USE_STEALTH`) instead of the 3-tier auto-cascade
`SURF_USE_STEALTH`	`true`	initial stealth tier — only consulted when `SURF_CASCADE_DISABLED=true`
`SURF_HUMANLIKE_MODE`	`off`	`off` / `background` (fire-and-forget after returning results) / `inline` (await before returning, slower) — opt-in humanlike browsing
`SURF_RATE_LIMIT_PER_MIN`	`10`	internal cap on Google-facing requests per minute
`SURF_CACHE_TTL_SEARCH_MS`	`86400000`	search cache TTL (24h); `0` disables caching
`SURF_CACHE_MAX_ENTRIES`	`1000`	LRU cap per cache namespace
`SURF_CACHE_ROOT`	`<profile>/cache`	cache directory
`SURF_INSECURE_TLS`	`=SURF_CLOUD_MODE`	`--ignore-certificate-errors` (auto-on in cloud mode)
`SURF_NO_SANDBOX`	`=SURF_CLOUD_MODE`	`--no-sandbox` (auto-on in cloud mode)
`SURF_TELEMETRY`	`false`	set `true` to enable jsonl event logging (search outcomes, cache hits/misses, tool errors, parser staleness) under `{SURF_TELEMETRY_ROOT}`. Designed as the input feed for the self-healing pipeline. Off by default.
`SURF_TELEMETRY_ROOT`	`<profile>/telemetry`	directory for jsonl telemetry files. UTC-dated one file per day (`YYYY-MM-DD.jsonl`).
`SURF_SELF_HEALING`	`true`	per-strategy outcome tracking + persisted reordering. Healing must win by 3 outcomes before reorder kicks in, so single-call flapping is impossible. Set `false` to pin the default strategy order.
`SURF_SELF_HEALING_FILE`	`<profile>/.heal/strategy-order.json`	persistence path for healing state. Atomic tmp+rename writes; debounced 5s.
`SURF_LLM_HEAL`	`false`	opt-in for LLM-assisted selector repair in the workflow-only `repairWithLLM` helper. Off by default → no third-party LLM request ever fires. When `true`, requires `ANTHROPIC_API_KEY` (your own); the package never ships a maintainer key.
`ANTHROPIC_API_KEY`	—	your Anthropic key. Read only when `SURF_LLM_HEAL=true`. The runtime self-healing in `SURF_SELF_HEALING` is deterministic and never reads this variable.

Troubleshooting

CAPTCHA in 4 modes (picked automatically from env):
default (local desktop): OS notification fires, headed Chrome opens, human solves, call retries
SURF_HEADLESS=false: headed Chrome opens, no notification (user is already watching)
SURF_REMOTE_DEBUG=true: DevTools port + instructions printed, attach chrome://inspect locally to solve
SURF_CLOUD_MODE=true: fail-fast with CAPTCHA_REQUIRED error
Headed Chrome opens to a plain search box instead of CAPTCHA: just type any query in the box and press Enter. Subsequent calls work.
"Chrome not found": install Chrome or set CHROME_PATH.
Stale selectors: two-layer mitigation — runtime per-strategy reorder (SURF_SELF_HEALING, deterministic) + daily cron that opens draft PRs with candidate fixes (SURF_LLM_HEAL optional, human review required, never auto-merged).
Searches feel slower than the Numbers table: check health().pool.fallback. true means the worker pool gave up after 3 warm failures and is using a single context. Usually fixed by npm run bootstrap to refresh the seed profile.
SSRF: extract blocks localhost, private IPs, AWS metadata by default. Set SURF_ALLOW_PRIVATE=true to allow them.

🎯 aiskill88 AI 点评 A 级 2026-05-21

集合搜索、抓取、论文三大功能于一身的MCP工具，消除API依赖，开箱即用，是Claude应用的优质扩展方案。

📚 实用指南（长尾问题）

适合谁

需要让 Claude / Cursor 操作本地工具的 AI 工程师

最佳实践

配置 MCP 服务器时建议使用 stdio 传输 + JSON-RPC，避免暴露公网

常见错误

API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
MCP 配置路径拼错或权限不足，重启 Claude Desktop 才生效

部署方案

云端托管：可放在 Vercel / Railway / Fly.io 等 PaaS 平台

⚡ 核心功能

通过标准 MCP 协议与 Claude、Cursor 等主流 AI 客户端深度集成
提供结构化工具调用接口，显著降低 AI 集成复杂度
支持 Claude Desktop 和 Claude Code 无缝接入，开箱即用
可与其他 MCP 工具组合叠加，构建完整 AI 工作站
轻量无侵入设计，不影响现有系统架构

👥 适合谁

需要让 Claude / Cursor 操作本地工具的 AI 工程师

⭐ 最佳实践

配置 MCP 服务器时建议使用 stdio 传输 + JSON-RPC，避免暴露公网

⚠️ 常见错误

API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
MCP 配置路径拼错或权限不足，重启 Claude Desktop 才生效

👥 适合人群

Claude Desktop / Claude Code 用户AI 工具开发者需要扩展 AI 能力的专业人士自动化工程师

🎯 使用场景

在 Claude Desktop 对话中直接调用本地工具，实现 AI 与系统的深度联动
通过自然语言驱动复杂的多步骤自动化任务，代替繁琐手动操作
将多个 MCP 工具组合使用，构建个人专属 AI 工作站

⚖️ 优点与不足

✅ 优点

+MIT 协议，可免费商用
+标准化 MCP 协议，生态互联性强
+与 Claude 官方生态无缝对接
+即插即用，配置简单快捷

⚠️ 不足

−依赖 Claude 客户端，非 Claude 用户无法使用
−MCP 协议仍在持续演进，接口可能变更
−需要一定的配置步骤

⚠️ 使用须知

AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。

建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。

📄 License 说明

🔗 相关工具推荐

github-mcp-server MCP工具

GitHub官方MCP服务器实现，使AI助手能直接操作GitHub仓库、问题、拉取请求等资源。采用Go语言开发，高性能稳

全市场股票行情MCP接口

一个基于MCP协议的开源股票数据接口工具，支持A股、美股及港股的实时行情与基金数据查询。它允许AI助手直接获取金融市场数

MCP 服务器资源汇总

汇集开源MCP（模型上下文协议）服务器的权威目录库。为开发者提供丰富的MCP服务器实现和集成方案，支持AI应用快速扩展功

playwright-mcp MCP工具

基于Playwright的MCP协议服务器实现，提供浏览器自动化能力。支持网页交互、截图、数据采集等功能，适合开发者集成

📚 相关教程推荐

AI 写作提效工作流：从 Prompt 设计到批量内容生产

帮助中心 · AI Skill Hub

🧩 你可能还需要

基于当前 Skill 的能力图谱，自动补全的工具组合

基于MCP协议的WordPress内容管理服务器，为Claude AI提供WordPress CMS系统的完整管理能力。支持文章、页面、分类

total-agent-memory MCP工具

为Claude Code和Codex CLI提供持久化记忆功能的开源MCP工具。自动提取知识图谱，支持多轮对话上下文保留，适合需要长期记忆和

MassGen多智能体系统

MCP · Agent · 工作流

❓ 常见问题 FAQ

是否需要Google API密钥？−

不需要，该工具设计为无密钥使用，直接调用Google搜索。

能否被反爬虫检测？+

MCP 是什么？和普通 API 有什么区别？+

我需要编程基础才能使用这个 MCP 工具吗？+

这个工具支持 Claude Code 吗？还是只有 Claude Desktop？+

MCP 工具是否会访问我的本地文件或数据？+

多个 MCP 工具可以同时使用吗？+

💡 AI Skill Hub 点评

总体来看，google-surf-mcp MCP工具是一款质量优秀的MCP工具，在同类工具中具备一定竞争力。AI Skill Hub 将持续追踪其更新动态，建议收藏备用，结合自身场景选择合适时机引入使用。

⬇️ 获取与下载

⬇ 下载源码 ZIP

✅ MIT 协议 · 可免费商用 · 直接从 aiskill88 服务器下载，无需跳转 GitHub

📚 深入学习 google-surf-mcp MCP工具

查看分步骤安装教程和完整使用指南，快速上手这款工具

⚙️ 安装教程 📚 使用教程

🌐 原始信息

原始名称	`google-surf-mcp`
原始描述	开源MCP工具：Google search MCP. No API key. One MCP replaces search + fetch + academic-paper 。⭐173 · TypeScript
Topics	`Google搜索MCP协议无需密钥网页抓取学术论文`
GitHub	https://github.com/HarimxChoi/google-surf-mcp
License	MIT
语言	TypeScript

🔗 原始来源

🐙 GitHub 仓库 https://github.com/HarimxChoi/google-surf-mcp

收录时间：2026-05-18 · 更新时间：2026-05-19 · License：MIT · AI Skill Hub 不对第三方内容的准确性作法律背书。

google-surf-mcp MCP工具

简介

Install

Env vars

Troubleshooting

🤖 交给 Agent 安装 · google-surf-mcp MCP工具