Serper (Google Search)

🚀 Serper MCP サーバー

このサーバーは、Google 検索 via Serper を提供するモデルコンテキストプロトコル (MCP) サーバーです。大型言語モデル (LLM) が Google の検索結果情報を取得できるようにします。

✨ 主な機能

利用可能なツール

• google_search - 検索結果を取得します。
  • 必須パラメータ:
    • q (文字列): 検索するクエリ
  • オプションパラメータ:
    • gl (文字列): 検索を行う国、例: us, uk, ca, au など。
    • location (文字列): 検索の位置、例: San Francisco, CA, USA
    • hl (文字列): 検索の言語、例: en, es, fr, de など。
    • tbs (文字列): 検索の時間範囲、例: d（日）、w（週）、m（月）、y（年）
    • num (整数): 返す結果の数、最大 100（デフォルト値: 10）
    • page (整数): 返すページ番号、最初のページは 1（デフォルト値: 1）

📦 インストール

uv を使用する方法（推奨）

1. オペレーティングシステムに uv がインストールされていることを確認してください。

2. MCP クライアントコードの設定ファイルまたは Claude の設定（claude_desktop_config.json ファイル）に serper MCP サーバーを追加します。

   {
       "mcpServers": {
           "serper": {
               "command": "uvx",
               "args": ["serper-mcp-server"],
               "env": {
                   "SERPER_API_KEY": "<Your Serper API key>"
               }
           }
       }
   }
   

   uv は自動的に pypi.org から MCP サーバーをダウンロードし、MCP クライアントに適用します。

pip プロジェクトを使用する方法

1. MCP クライアントコードの requirements.txt ファイルに serper-mcp-server を追加します。

   serper-mcp-server
   

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

   pip install -r requirements.txt
   

3. クライアント設定を追加します。

   {
       "mcpServers": {
           "serper": {
               "command": "python3",
               "args": ["-m", "serper_mcp_server"],
               "env": {
                   "SERPER_API_KEY": "<Your Serper API key>"
               }
           }
       }
   }
   

pip をグローバルに使用する方法

1. システムに pip または pip3 がインストールされていることを確認してください。

   pip install serper-mcp-server
   # または
   pip3 install serper-mcp-server
   

2. MCP クライアントコードの設定ファイルまたは Claude の設定に serper MCP サーバーを追加します。

   {
       "mcpServers": {
           "serper": {
               "command": "python3",
               "args": ["serper-mcp-server"],
               "env": {
                   "SERPER_API_KEY": "<Your Serper API key>"
               }
           }
       }
   }
   

💻 使用例

デバッグ方法

サーバーのデバッグには MCP インスペクターを使用できます。uvx でインストールした場合:

npx @modelcontextprotocol/inspector uvx serper-mcp-server

または、特定のディレクトリにパッケージをインストールした場合、もしくは開発中の場合:

cd path/to/your/directory
npm install -g @modelcontextprotocol/inspector
@modelcontextprotocol/inspector uvx serper-mcp-server

📄 注意事項

⚠️ 重要提示

有効な Serper API キーを取得し、ドキュメントに従って環境変数を正しく設定してください。