Serper

🚀 Serper 検索を使用するモデルコンテキストプロトコルサーバー

Serper を通じた Google 検索を提供する Model Context Protocol サーバーです。このサーバーにより、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": "<あなたの Serper API キー>"
               }
           }
       }
   }
   

   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": "<あなたの Serper API キー>"
               }
           }
       }
   }
   

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": "<あなたの Serper API キー>"
               }
           }
       }
   }
   

💻 使用例

基本的な使用法

上記のインストール方法に従ってサーバーをセットアップし、MCP クライアントから google_search ツールを使用して検索結果を取得できます。

🔧 デバッグ

MCP チェックツールを使用してサーバーをデバッグすることができます。uvx でインストールした場合：

npx @modelcontextprotocol/inspector uvx serper-mcp-server

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

cd path/to/servers/src/serper
npx @modelcontextprotocol/inspector uv 実行 serper-mcp-server

📄 ライセンス

serper-mcp-server は MIT ライセンスの下で提供されています。