MCP Server Serper

🚀 Serperを使用したMCPサーバーの検索とスクレイピング

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

✨ 主な機能

ツール

• google_search - Serper APIを通じてウェブ検索を実行します

  • 有機的な検索結果、知識グラフ、「人々もよく検索する」、関連検索など、豊富な検索結果を提供します
  • 地域と言語の指定に対応しています
  • 位置、ページング、時間フィルター、自動修正などのオプションパラメータがあります
  • 高度な検索演算子をサポートしています：
    • site：特定のドメイン名の結果に限定します
    • filetype：特定のファイルタイプ（例：'pdf'、'doc'）に限定します
    • inurl：指定した単語を含むURLのページを検索します
    • intitle：タイトルに指定した単語を含むページを検索します
    • related：類似したウェブサイトを検索します
    • cache：Googleキャッシュ内の特定のURLのバージョンを表示します
    • before：YYYY-MM-DD形式で指定した日付より前の結果を取得します
    • after：YYYY-MM-DD形式で指定した日付より後の結果を取得します
    • exact：正確なフレーズマッチングを行います
    • exclude：検索結果から除外する用語を指定します
    • or：代替語（OR演算子）を使用します

• scrape - ウェブページからコンテンツを抽出します

  • 純粋なテキストとオプションのMarkdown形式のコンテンツを取得します
  • JSON-LDとヘッダーメタデータを含みます
  • CookieとJavaScriptレンダリングをサポートしています

📦 インストール

必要条件

• Node.jsバージョン：14.19.1以上
• 環境変数SERPER_API_KEYを設定する必要があります。取得方法は公式サイトを参照してください。

依存関係のインストール

npm install

プロジェクトのビルド

npm run build

サーバーの起動

npm start

💻 使用例

基本的な使用法

# 依存関係のインストール
npm install
# プロジェクトのビルド
npm run build
# サーバーの起動
npm start

高度な使用法

# デバッグ時にPuppeteerのメモリ制限を下げる場合
npm run dev --args=--memory=1024MB

🔧 技術詳細

デバッグの提案

問題が発生した場合は、以下のログを確認してください：

• src/utils/logger.ts - 基本情報を記録します
• src/utils/selenium_logger.ts - ブラウザ操作のログを記録します

インストール方法

Smithery CLIを使用したインストール

npx serper create@mcp-server-serper mcp-server
cd mcp-server
npm install

Claude Desktopの設定

方法1：コマンドを直接実行する

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

方法2：カスタム起動項目を作成する

• 名前：任意の名前
• コマンド：env SERPER_API_KEY=your_api_key_here npx -y serper-search-scrape-mcp-server

Clineの設定

Clineの「MCPサーバー」セクションで、新しいサーバーを追加します：

• 「コマンド」タイプを選択します
• 「コマンド」フィールドに以下の内容を入力します：

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

Dockerを使用した実行

イメージのビルド

docker build -t mcp-server-serper .

コンテナの起動

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