Skip to main content
Glama
fukayatti

Google Web Search MCP Server

by fukayatti
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

Google Web Search MCP Server

npm version License: Apache 2.0

Google Custom Search API を使用した Model Context Protocol (MCP) サーバーです。gemini-cli と google/genai のgoogle_web_searchツールと完全互換性があります。

特徴

  • gemini-cli 互換: google_web_searchツールを完全再現

  • google/genai 互換: Google GenAI SDK の検索機能と同等

  • 構造化された結果: 引用付きの詳細な検索結果

  • メタデータサポート: Open Graph データ、公開日時、画像情報を含む

  • エラーハンドリング: 詳細なエラーメッセージとトラブルシューティング情報

Related MCP server: Deno Gemini Grounding MCP Server

セットアップ

1. 依存関係のインストール

npm install -g @fukayatti0/googlesearch-mcp

2. 環境変数の設定

以下の環境変数を設定してください：

export GOOGLE_API_KEY="your_google_api_key"
export CUSTOM_SEARCH_ENGINE_ID="your_custom_search_engine_id"

3. Google Custom Search API の設定

  1. Google Cloud Consoleでプロジェクトを作成

  2. Custom Search JSON API を有効化

  3. API キーを作成

  4. Programmable Search Engineでカスタム検索エンジンを作成

    • ウェブ全体を検索を有効にする（*を検索対象に追加）

  5. 検索エンジン ID を取得。

使用方法

MCP クライアントでの使用

このサーバーは以下のツールを提供します：

google_web_search (gemini-cli 互換)

Google Web 検索します。gemini-cli のgoogle_web_searchツールと同じインターフェースです。

パラメータ:

  • query (string, 必須): 検索クエリ

例:

google_web_search(query="latest advancements in AI-powered code generation")

google_search (後方互換性)

Google 検索します。追加のパラメータをサポートします。

パラメータ:

  • query (string, 必須): 検索クエリ

  • num_results (number, オプション): 返す結果の数 (デフォルト: 10, 最大: 10)

例:

{
  "name": "google_search",
  "arguments": {
    "query": "TypeScript MCP server",
    "num_results": 5
  }
}

出力形式

検索結果は以下の構造化された形式で返されます：

# Web Search Results for "your query"

Found 1,234,567 results in 0.45 seconds

## 1. Page Title

**URL:** https://example.com/page
**Domain:** example.com
**Snippet:** Brief description of the page content...
**Description:** More detailed Open Graph description if available
**Published:** 2024-01-15T10:30:00Z
**Image:** https://example.com/image.jpg

---

## Sources

[1] Page Title - https://example.com/page
[2] Another Page - https://example.com/another

MCP 設定例

Claude Desktop / Kiro

{
  "mcpServers": {
    "google-web-search": {
      "command": "node",
      "args": ["/path/to/googlesearch-mcp/build/index.js"],
      "env": {
        "GOOGLE_API_KEY": "your_google_api_key",
        "CUSTOM_SEARCH_ENGINE_ID": "your_custom_search_engine_id"
      }
    }
  }
}

uvx 経由での実行

{
  "mcpServers": {
    "google-web-search": {
      "command": "npx",
      "args": ["@fukayatti0/googlesearch-mcp"],
      "env": {
        "GOOGLE_API_KEY": "your_google_api_key",
        "CUSTOM_SEARCH_ENGINE_ID": "your_custom_search_engine_id"
      }
    }
  }
}

gemini-cli との互換性

この MCP サーバーは、gemini-cli のgoogle_web_searchツールと完全に互換性があります。

  • 同じツール名: google_web_search

  • 同じパラメータ: queryのみ

  • 同じ出力形式: 構造化された Markdown 形式

  • 同じ機能: Web 検索結果の要約と引用

gemini-cli から移行する場合、設定を変更するだけで同じ機能を利用できます。

トラブルシューティング

よくあるエラー

  1. API Key not found: GOOGLE_API_KEY環境変数が設定されていません

  2. Custom Search Engine ID not found: CUSTOM_SEARCH_ENGINE_ID環境変数が設定されていません

  3. API quota exceeded: 1 日 100 クエリの無料枠を超過しました

  4. Invalid API key: API キーが無効または権限がありません

制限事項

  • 無料枠: 1 日 100 クエリまで無料

  • 結果数: 最大 10 件まで（Google Custom Search API の制限）

  • レート制限: 秒間 100 クエリまで

License

This project is licensed under the Apache 2.0 License. See the LICENSE file for details.

Available Tools

2 tools

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 2 tool updatesv1.1.1
    • First observedgoogle_search
    • First observedgoogle_web_search
Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

D1.5/5.0

Scored across 2 tools

Disambiguation1/5

The two tools, google_web_search and google_search, appear to perform the same action and have no descriptions to distinguish them. An agent cannot reliably tell when to use one over the other.

Naming Consistency4/5

Both names use snake_case with a google_ prefix, following a consistent convention. The only minor deviation is the extra 'web' token in one name, which does not break the pattern.

Tool Count3/5

Two tools is borderline thin for a search server, and they are redundant rather than complementary. A single clear search tool would likely suffice for the stated purpose.

Completeness2/5

The surface lacks any description or differentiation between the two search tools. There are no obvious complementary operations such as image search, news search, pagination, or filters to cover a broader search domain.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Tavily Web Search MCP Server

    nilay320
    F
    license
    B
    quality
    D
    maintenance
    Enables web search capabilities through the Tavily API. Allows users to search the web for information using natural language queries via the MCP protocol.
    4
    1
    -

  • Deno Gemini Grounding MCP

    rinerebox1
    A
    license
    Not graded
    quality
    D
    maintenance
    Provides Google search grounding capabilities for Gemini AI models through MCP, enabling AI assistants to perform web searches with Gemini's grounding API for more accurate and up-to-date responses.
    MIT

  • gemini-search-mcp

    Sophomoresty
    A
    license
    A
    quality
    F
    maintenance
    MCP server for web search powered by Google AI Mode (Gemini). Enables any AI agent to search the web in real-time for free and without rate limits.
    2
    182
    MIT