gsearch

インストール

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 認証情報も引き続き読み取れます。

通常の使用では、レート制限は十分に余裕があります。短時間にリクエストが集中した場合、サーバーは動的なバックオフを適用して自動的に再試行します。

認証

次の 2 つの方法があります。

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 プロジェクトは自動的に特定されます（初回の使用時に SMS 認証が必要な場合があります）。アカウントでユーザー定義のプロジェクトが必要な場合、インストーラーで既存の 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