G-Search MCP

G-Search MCP

複数のキーワードを同時に並列検索できる、Google 検索用の強力な MCP サーバーです。

このプロジェクトは google-search を改変したものです。

🌟 おすすめ：OllaMan - 強力な Ollama AI モデルマネージャーです。

メリット

• 並列検索：複数のキーワードを同時に Google で検索でき、検索効率が向上します
• ブラウザーの最適化：1 つのブラウザーインスタンスで複数のタブを開き、効率的な並列検索を実行します
• 検証への自動対応：CAPTCHA をインテリジェントに検出し、必要に応じてユーザーが検証できるよう、ブラウザーを表示モードにします
• ユーザー行動のシミュレーション：実際のユーザーのブラウジングパターンをシミュレートし、検索エンジンに検出される可能性を低減します
• 構造化データ：処理や分析が容易な、JSON 形式の構造化された検索結果を返します
• 設定可能なパラメーター：検索結果の上限、タイムアウト設定、ロケール設定など、さまざまなパラメーターを設定できます

クイックスタート

npx で直接実行します：

npx -y g-search-mcp

初回セットアップ時は、ターミナルで次のコマンドを実行して、必要なブラウザーをインストールしてください：

npx playwright install chromium

デバッグモード

--debug オプションを使うと、デバッグモード（ブラウザーウィンドウを表示）で実行できます：

npx -y g-search-mcp --debug

MCP の設定

この MCP サーバーを Claude Desktop で設定します：

MacOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "g-search": {
      "command": "npx",
      "args": ["-y", "g-search-mcp"]
    }
  }
}

機能

• search - 複数のキーワードで Google 検索を実行し、結果を返します
  • Playwright ブラウザーを使って検索を実行します
  • 次のパラメーターに対応しています：
    • queries：実行する検索クエリの配列（必須パラメーター）
    • limit：クエリごとに返す結果の最大数。デフォルトは 10 です
    • timeout：ページ読み込みのタイムアウト時間（ミリ秒）。デフォルトは 60000（60 秒）です
    • noSaveState：ブラウザーの状態を保存しないかどうか。デフォルトは false です
    • locale：検索結果のロケール設定。デフォルトは en-US です
    • debug：デバッグモード（ブラウザーウィンドウを表示）を有効にするかどうか。コマンドラインの --debug フラグより優先されます

使用例：

Use the search tool to search for "machine learning" and "artificial intelligence" on Google

応答例：

{
  "searches": [
    {
      "query": "machine learning",
      "results": [
        {
          "title": "What is Machine Learning? | IBM",
          "link": "https://www.ibm.com/topics/machine-learning",
          "snippet": "Machine learning is a branch of artificial intelligence (AI) and computer science which focuses on the use of data and algorithms to imitate the way that humans learn, gradually improving its accuracy."
        },
        ...
      ]
    },
    {
      "query": "artificial intelligence",
      "results": [
        {
          "title": "What is Artificial Intelligence (AI)? | IBM",
          "link": "https://www.ibm.com/topics/artificial-intelligence",
          "snippet": "Artificial intelligence leverages computers and machines to mimic the problem-solving and decision-making capabilities of the human mind."
        },
        ...
      ]
    }
  ]
}

使用上のヒント

特殊なウェブサイトの状況への対応

検索パラメーターの調整

• 検索結果の数：検索結果を増やすには：

  Please return the top 20 search results for each keyword
  

  これにより、limit: 20 パラメーターが設定されます。

• タイムアウト時間の延長：読み込みが遅い場合：

  Please set the page loading timeout to 120 seconds
  

  これにより、timeout パラメーターが 120000 ミリ秒に調整されます。

ロケール設定の調整

• 検索地域の変更：別のロケール設定を指定します：

  Please use Chinese locale (zh-CN) for searching
  

  これにより、locale: "zh-CN" パラメーターが設定されます。

デバッグとトラブルシューティング

デバッグモードの有効化

• デバッグの動的な有効化：特定の検索操作中にブラウザーウィンドウを表示するには：

  Please enable debug mode for this search operation
  

  サーバーの起動時に --debug フラグを指定していなくても、debug: true に設定されます。

インストール

前提条件

• Node.js 18 以上
• NPM または Yarn

ソースからインストール

1. リポジトリをクローンします：

git clone https://github.com/jae-jae/g-search-mcp.git
cd g-search-mcp

2. 依存関係をインストールします：

npm install

3. Playwright ブラウザーをインストールします：

npm run install-browser

4. サーバーをビルドします：

npm run build

開発

自動リビルド（開発モード）

npm run watch

デバッグに MCP Inspector を使用する

npm run inspector

関連プロジェクト

• fetcher-mcp：Playwright のヘッドレスブラウザーを使ってウェブページのコンテンツを取得する、強力な MCP サーバーです。インテリジェントなコンテンツ抽出、並列処理、リソースの最適化などの機能を備えており、ウェブコンテンツのスクレイピングに最適なツールです。

ライセンス

MIT License のもとでライセンスされています。