AgentHubAgentHub

google-surf-mcp

MCP ServerMCP Registry官方收录

io.github.HarimxChoi/google-surf-mcp · v0.4.6

Google search via Playwright with a warm Chrome profile. No API key, no proxies.

源仓库 ↗

概览

google-surf-mcp 是一个MCP Server，收录自 官方 MCP Registry。支持 stdio 传输。本页提供 Cursor、Claude Code 等客户端的安装配置片段。

安装

选择你的平台查看安装方式

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

环境变量

CHROME_PATH可选

Absolute path to the Chrome binary. Auto-detected on Windows/macOS/Linux when omitted.

SURF_PROFILE_ROOT可选

Directory for the warm Chrome profile. Defaults to ~/.google-surf-mcp.

SURF_LOCALE可选

Browser locale, e.g. en-US.

SURF_TZ可选

IANA timezone, e.g. America/New_York. Defaults to system timezone.

SURF_HEADLESS可选

Set to 'false' to run Chrome visibly (demos/debugging). Defaults to true. CAPTCHA recovery always runs visible regardless.

SURF_IDLE_CLOSE_MS可选

Idle ms before closing the sequential ctx and pool. 0 disables idle auto-close. Defaults to 30000.

SURF_ALLOW_PRIVATE可选

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.

相关资源

统一 Manifest

{
  "id": "io.github.HarimxChoi/google-surf-mcp",
  "type": "mcp-server",
  "version": "0.4.6",
  "displayName": "google-surf-mcp",
  "description": "Google search via Playwright with a warm Chrome profile. No API key, no proxies.",
  "repository": {
    "url": "https://github.com/HarimxChoi/google-surf-mcp",
    "source": "github"
  },
  "distribution": {
    "packages": [
      {
        "registryType": "npm",
        "identifier": "google-surf-mcp",
        "version": "0.4.6",
        "transport": "stdio",
        "environmentVariables": [
          {
            "name": "CHROME_PATH",
            "description": "Absolute path to the Chrome binary. Auto-detected on Windows/macOS/Linux when omitted."
          },
          {
            "name": "SURF_PROFILE_ROOT",
            "description": "Directory for the warm Chrome profile. Defaults to ~/.google-surf-mcp."
          },
          {
            "name": "SURF_LOCALE",
            "description": "Browser locale, e.g. en-US."
          },
          {
            "name": "SURF_TZ",
            "description": "IANA timezone, e.g. America/New_York. Defaults to system timezone."
          },
          {
            "name": "SURF_HEADLESS",
            "description": "Set to 'false' to run Chrome visibly (demos/debugging). Defaults to true. CAPTCHA recovery always runs visible regardless."
          },
          {
            "name": "SURF_IDLE_CLOSE_MS",
            "description": "Idle ms before closing the sequential ctx and pool. 0 disables idle auto-close. Defaults to 30000."
          },
          {
            "name": "SURF_ALLOW_PRIVATE",
            "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."
          }
        ]
      }
    ],
    "remotes": []
  },
  "dependencies": [],
  "installTargets": [
    "claude-code",
    "claude-desktop",
    "cursor",
    "vscode"
  ],
  "keywords": [],
  "provenance": {
    "origin": "official-mcp-registry",
    "originalId": "io.github.HarimxChoi/google-surf-mcp",
    "originalUrl": "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.HarimxChoi%2Fgoogle-surf-mcp/versions/latest",
    "isOfficial": true,
    "status": "active"
  }
}
google-surf-mcp — MCP Server 安装与配置 · AgentHub