AI导哈

谷歌搜索MCP服务

GSearch是一款免费的谷歌搜索MCP服务，为AI工具提供实时网络搜索功能，支持多种认证方式，无运行时依赖。

  • by daanielcruz
  • Go
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 daanielcruz/gsearch-mcp

使用说明

🚨 免责声明🚨

这只是一个提醒。我们还没有看到任何禁止使用GSearch的禁令。

与谷歌无关。使用与 开源Gemini CLI.

谷歌最近禁止了一些OpenClaw用户。在我看来，oauth提供商的OpenClaw用例看起来很糟糕。GSearch不符合这种模式。风险依然存在。

请求携带Gemini CLI的User-Agent、ideType和请求形状，因此它们可能与在线的官方客户端无法区分 （如果你是一个谷歌用户，读到这句话：我们是好人，请不要追捕我们🙏)。如果这让你感到困扰，请使用一次性谷歌帐户。

GSearch-免费谷歌搜索MCP

为Claude Code、Codex CLI、Cursor和其他人工智能工具提供基于谷歌搜索的实时网络搜索。单一二进制，零运行时依赖关系。 免费使用任何Google帐户。

安装

curl -fsSL https://raw.githubusercontent.com/daanielcruz/gsearch-mcp/main/install.sh | bash

或者从源代码构建：

git clone https://github.com/daanielcruz/gsearch-mcp && cd gsearch-mcp
make build && ./gsearch-installer

安装程序下载二进制文件，自动配置Claude Code、Codex和Cursor（如果可用）。

运作原理

Claude Code / Codex CLI / Cursor / Others...
        | MCP (stdio)
   gsearch-server (Go binary)
        | OAuth2
   Google Code Assist API
        | googleSearch grounding
   Answer with [1][2][3] source links

当AI工具调用时 google_search，GSearch返回一个带内联引用的可靠答案：

The current time in Sao Paulo is 08:13 AM.[1][2]
Sao Paulo observes Brasilia Time (BRT), UTC-3.[3]

Sources:
[1] Time in Sao Paulo (https://...)
[2] World Clock (https://...)
[3] Time Zone Info (https://...)

定价和限额

GSearch使用与以下相同的基于Google搜索的API Gemini CLI. 免费使用任何Google帐户。 没有API密钥，没有信用卡，没有账单设置。

对于正常使用，费率限制是慷慨的。服务器在快速突发时自动重试，并动态回退。

认证

三种选择：

  1. Gemini CLI （如果已安装）--GSearch重用来自的现有凭据 ~/.gemini/oauth_creds.json
  2. 交互式OAuth — ./gsearch-installer 打开浏览器进行谷歌登录
  3. API密钥 -从粘贴Gemini API密钥 aistudio.google.com 进入安装程序，或设置 GEMINI_API_KEY / GSEARCH_API_KEY env 是

OAuth通过Google Code Assist API模式自动生产新帐户（首次使用时可能需要进行SMS验证）。API密钥模式完全跳过OAuth，直接命中Gemini API。

配置

安装程序会自动配置所有内容。对于手动设置，请在MCP客户端配置中添加：

{
  "mcpServers": {
    "gsearch": {
      "command": "npx",
      "args": ["-y", "@daanielcruz/gsearch-mcp"]
    }
  }
}

使用Claude Code(~/.claude.json)，光标(~/.cursor/mcp.json)，以及任何与MCP兼容的工具。

用于Codex CLI(~/.codex/config.toml):

[mcp_servers.gsearch]
command = 'npx'
args = ['-y', '@daanielcruz/gsearch-mcp']

集 GSEARCH_PROJECT 仅当自动检测失败时才使用env-var。

许可证

麻省理工学院

相关 MCP