Serper Search and Scrape MCP Server

Serper Search and Scrape MCP サーバー

Serper API を使用してウェブ検索とウェブページのスクレイピング機能を提供する、TypeScript ベースの MCP サーバーです。このサーバーは Claude Desktop と連携し、高度なウェブ検索とコンテンツ抽出機能を実現します。

機能

ツール

• 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 - ウェブページからコンテンツを抽出します

  • プレーンテキストと、任意で Markdown 形式のコンテンツを取得
  • JSON-LD と head メタデータを含む
  • ドキュメントの構造を保持

要件

• 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

Inspector は、ブラウザーでデバッグツールにアクセスするための URL を表示します。

インストール

Smithery 経由でインストール

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

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

Claude Desktop

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

• 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

1. Cline 拡張機能の設定を開きます
2. 「MCP Servers」タブを開きます
3. 「Configure MCP Servers」をクリックします
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：使用のたびに明示的な承認を必要としないツールの一覧

Cursor

1. Cursor の設定を開きます
2. 「Features」設定を開きます
3. 「MCP Servers」セクションで「Add new MCP Server」をクリックします
4. 名前を選び、「Type」として「command」を選択します
5. 「Command」フィールドに次の内容を入力します：

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

Docker

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