Serper検索とスクレイピングMCPサーバー

Serper APIを使用したWeb検索およびWebページスクレイピング機能を提供するTypeScriptベースのMCPサーバーです。このサーバーはClaude Desktopと統合されており、強力なWeb検索機能とコンテンツ抽出機能を実現します。

特徴

ツール

• google_search - Serper API 経由でウェブ検索を実行する

  • オーガニック検索結果、ナレッジグラフ、「他のユーザーも質問しています」、関連検索など、豊富な検索結果

  • 地域と言語のターゲティングをサポート

  • 場所、ページネーション、時間フィルター、自動修正のオプションパラメータ

  • 高度な検索演算子をサポートします:

    • site : 結果を特定のドメインに限定する

    • filetype : 特定のファイルタイプに制限します（例: 'pdf'、'doc'）

    • inurl : URLに単語を含むページを検索

    • intitle : タイトルに単語が含まれるページを検索

    • related ：類似のウェブサイトを探す

    • cache : 特定の URL の Google のキャッシュ バージョンを表示します

    • before : YYYY-MM-DD形式の以前の日付

    • after : YYYY-MM-DD形式の日付

    • exact : 完全なフレーズ一致

    • exclude : 検索結果から除外する用語

    • or : 代替用語（OR演算子）

• scrape - Webページからコンテンツを抽出する

  • プレーンテキストとオプションのマークダウンコンテンツを取得する

  • JSON-LDとヘッドメタデータを含む

  • 文書構造を保持

Related MCP server: go_serper_mcp_server

要件

• Node.js >= 18

• Serper API キー ( SERPER_API_KEY環境変数として設定)

発達

依存関係をインストールします:

npm install

サーバーを構築します。

npm run build

自動リビルドを使用した開発の場合:

npm run watch

テストを実行します:

npm test                  # Run all tests
npm run test:watch       # Run tests in watch mode
npm run test:coverage    # Run tests with coverage
npm run test:integration # Run integration tests

環境変数

ルート ディレクトリに.envファイルを作成します。

SERPER_API_KEY=your_api_key_here

デバッグ

MCPサーバーはstdio経由で通信するため、デバッグが困難になる場合があります。パッケージスクリプトとして提供されているMCP Inspectorの使用をお勧めします。

npm run inspector

インスペクターは、ブラウザでデバッグ ツールにアクセスするための URL を提供します。

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop に Serper Search and Scrape を自動的にインストールするには:

npx -y @smithery/cli install @marcopesani/mcp-server-serper --client claude

クロードデスクトップ

次の場所にサーバー設定を追加します:

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "serper-search": {
      "command": "npx",
      "args": ["-y", "serper-search-scrape-mcp-server"],
      "env": {
        "SERPER_API_KEY": "your_api_key_here"
      }
    }
  }
}

クライン

1. Cline拡張機能の設定を開く

2. 「MCPサーバー」タブを開く

3. 「MCPサーバーの構成」をクリックします

4. サーバー設定を追加します:

{
  "mcpServers": {
    "github.com/marcopesani/mcp-server-serper": {
      "command": "npx",
      "args": ["-y", "serper-search-scrape-mcp-server"],
      "env": {
        "SERPER_API_KEY": "your_api_key_here"
      },
      "disabled": false,
      "autoApprove": ["google_search", "scrape"]
    }
  }
}

追加のCline構成オプション:

• disabled : サーバーを有効にするにはfalseに設定します

• autoApprove : 使用ごとに明示的な承認を必要としないツールのリスト

カーソル

1. カーソル設定を開く

2. 「機能」設定を開く

3. 「MCPサーバー」セクションで、「新しいMCPサーバーを追加」をクリックします。

4. 名前を選択し、「タイプ」として「コマンド」を選択します

5. 「コマンド」フィールドに次のように入力します。

env SERPER_API_KEY=your_api_key_here npx -y serper-search-scrape-mcp-server

ドッカー

Dockerを使ってサーバーを実行することもできます。まずはイメージをビルドします。

docker build -t mcp-server-serper .

次に、Serper API キーを使用してコンテナを実行します。

docker run -e SERPER_API_KEY=your_api_key_here mcp-server-serper

あるいは、環境変数が.envファイルにある場合は、次のようにします。

docker run --env-file .env mcp-server-serper

開発の場合、ソース コードをボリュームとしてマウントする必要がある場合があります。

docker run -v $(pwd):/app --env-file .env mcp-server-serper

注意: your_api_key_here実際の Serper API キーに置き換えてください。