mcpField
G
gsearch

gsearch

本地服务
github.com/daanielcruz搜索与检索45 天前更新
代码仓库

关于 gsearch

gsearch 是基于 Go 的 MCP 服务，可返回由 Google Search 提供依据并带有行内引文的答案。它通过 OAuth 或 Gemini API 密钥连接 AI 工具与 Google Search grounding。

主要功能

  1. 01基于 Google Search 的回答
  2. 02行内来源引文
  3. 03OAuth 或 API 密钥认证
  4. 04自动重试与退避

适用场景

  1. 01在 AI 工具中获取最新网络信息
  2. 02接收附带引文的搜索结果
  3. 03遇到速率限制后重试搜索

MCP 相关

该服务通过 stdio 向 MCP 客户端提供 `google_search` 工具。客户端可通过配置的命令连接它。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "daanielcruz-gsearch": {
      "command": "npx",
      "args": [
        "-y",
        "@daanielcruz/gsearch-mcp"
      ],
      "env": {
        "GSEARCH_PROJECT": "<GSEARCH_PROJECT>",
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "GSEARCH_API_KEY": "<GSEARCH_API_KEY>"
      }
    }
  }
}
启动命令npx -y @daanielcruz/gsearch-mcp
需要配置的环境变量
GSEARCH_PROJECTOverride auto-detected Google Cloud project ID (OAuth mode)
GEMINI_API_KEY密钥Gemini API key (enables direct API key mode, bypasses OAuth)
GSEARCH_API_KEY密钥Alternate Gemini API key env var (same purpose as GEMINI_API_KEY)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@daanielcruz/gsearch-mcp1.2.3

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

🚨 免责声明 🚨

仅作提醒。我们尚未发现因使用 GSearch 而导致封禁的情况。

与 Google 无关联。使用与 Antigravity CLI 相同的公开 OAuth 客户端和 API。

GSearch - 免费 Google 搜索 MCP

GSearch - 免费 Google 搜索 MCP

Go License: MIT MCP

为 Claude Code、Codex CLI、Cursor、Otherside 及其他 AI 工具提供由 Google Search grounding 驱动的实时网络搜索。单个二进制文件，无运行时依赖。

安装

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 和 Otherside（如果可用）。

工作原理

Claude Code / Codex CLI / Cursor / Otherside / 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 通过公开的 OAuth 客户端使用与 Antigravity CLI 相同的 Google Search grounding API，也可使用带有 API 密钥的 Gemini API。限制、可用性和计费取决于所选的身份验证方式和 Google 账号。

官方 Gemini CLI 声明，免费账号和 Google One 账号已于 2026 年 6 月 18 日迁移至 Antigravity CLI，因此 GSearch 现在通过 Antigravity 的公开 OAuth 客户端登录。仍可读取现有的 Gemini CLI 凭据。

正常使用时，速率限制较为宽松。遇到短时间内大量请求时，服务端会自动重试，并动态调整退避时间。

身份验证

两种方式：

  1. Google 登录（Antigravity）：安装程序会通过 PKCE S256 和 localhost 环回回调，打开 Antigravity CLI 的公开 OAuth 流程。凭据存储在 ~/.gsearch/oauth_creds.json。
  2. API 密钥：将来自 aistudio.google.com 的 Gemini API 密钥粘贴到安装程序中，或设置 GEMINI_API_KEY / GSEARCH_API_KEY。此方式会跳过 OAuth，且不需要项目。Google 登录始终优先：存在 OAuth 凭据时，这些变量会被忽略。

Antigravity 登录会自动解析 Code Assist 项目（首次使用时可能需要短信验证）。如果账号要求使用用户自定义项目，安装程序会接受现有的 Project ID 并重试。它不会创建项目或启用计费。默认后端为 daily-cloudcode-pa.googleapis.com；设置 GSEARCH_ANTIGRAVITY_HOST=prod 可使用 cloudcode-pa.googleapis.com。

配置

安装程序会自动完成所有配置。若要手动设置，请在 MCP 客户端配置中添加：

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

适用于 Claude Code（~/.claude.json）、Cursor（~/.cursor/mcp.json）、Otherside（~/.otherside/.mcp.json）及其他兼容 MCP 的工具。

对于 Codex CLI（~/.codex/config.toml）：

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

仅当自动检测失败时才设置 GSEARCH_PROJECT 环境变量。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。