remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides web search capabilities via Serper API with rich search results, including organic results, knowledge graph, 'people also ask', and related searches from Google.

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とヘッドメタデータを含む
- 文書構造を保持

要件

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"
      }
    }
  }
}

クライン

Cline拡張機能の設定を開く
「MCPサーバー」タブを開く
「MCPサーバーの構成」をクリックします
サーバー設定を追加します:

{
  "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 : 使用ごとに明示的な承認を必要としないツールのリスト

カーソル

カーソル設定を開く
「機能」設定を開く
「MCPサーバー」セクションで、「新しいMCPサーバーを追加」をクリックします。
名前を選択し、「タイプ」として「コマンド」を選択します
「コマンド」フィールドに次のように入力します。

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 キーに置き換えてください。

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

この Serper MCP サーバーは、検索と Web ページのスクレイピング、および場所など Serper API によって導入された最新のすべてのパラメータをサポートしています。

Related Resources

Reddit Discussion about this server