MCP 服务器

Google Web Search MCP Server

Enables Google web search via MCP, compatible with gemini-cli's google_web_search tool.

README

Google Web Search MCP Server

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 データ、公開日時、画像情報を含む
エラーハンドリング: 詳細なエラーメッセージとトラブルシューティング情報

セットアップ

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 の設定

Google Cloud Consoleでプロジェクトを作成
Custom Search JSON API を有効化
API キーを作成
Programmable Search Engineでカスタム検索エンジンを作成
- ウェブ全体を検索を有効にする（*を検索対象に追加）
検索エンジン 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"
      }
    }
  }
}