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