Serper Search MCP Server

Serper 検索 MCP サーバー

Serper API を通じて Google 検索機能を提供する Model Context Protocol サーバーです。AI を活用した Deep Research ツールも備えています。このサーバーにより、MCP 対応アプリケーションに検索・リサーチ機能を簡単に統合できます。

✨ 特長

• 🌐 Serper API を通じた強力な Google 検索連携
• 🔄 次の情報を含む豊富な検索結果データ：
  • ナレッジグラフ情報
  • オーガニック検索結果
  • 「他の人はこちらも質問」への質問
  • 関連検索
• 🧠 AI を活用した Deep Research ツール：
  • 複数段階にわたる反復的なリサーチを実行
  • トピックを詳しく調べるためのサブクエリを生成
  • 複数の情報源から情報を統合
  • すべての情報に引用を提示
  • 調整可能なリサーチの深度レベル
  • 継続的な改善に役立つ品質指標を内蔵
• 🛠 設定可能な検索パラメーター：
  • 対象国
  • 言語の選択
  • 結果件数のカスタマイズ
  • 自動修正オプション
• 🔒 安全な API キーの取り扱い
• ⚡️ レート制限とキャッシュに対応
• 📝 型定義を完備した TypeScript 対応
• 📊 結果の最適化に役立つパフォーマンス指標を統合

🚀 インストール

1. リポジトリをクローンします：

git clone https://github.com/yourusername/serper-search-server.git
cd serper-search-server

2. 依存関係をインストールします：

pnpm install

3. サーバーをビルドします：

pnpm run build

⚙️ 設定

1. [Serper.dev](https://serper.de から Serper API キーを取得します

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

# Required
SERPER_API_KEY=your_api_key_here

# Optional - Advanced Quality Metrics Configuration (pre-configured by default)
USAGE_METRICS_KEY=your-custom-metrics-key     # Optional
USAGE_PROJECT_ID=your-custom-project-id       # Optional
METRICS_ENDPOINT=https://your-custom-host.com # Optional
DISABLE_METRICS=false                         # Not recommended

詳しくは TELEMETRY.md をご覧ください：

• 品質指標の収集
• パフォーマンスの監視
• 使用状況の分析
• ダッシュボードの設定
• 継続的な改善

🔌 統合

Claude Desktop

サーバー設定を Claude Desktop の設定ファイルに追加します：

MacOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "serper-search-server": {
      "command": "/path/to/serper-search-server/build/index.js",
      "env": {
        "SERPER_API_KEY": "your_api_key_here"
      }
    }
  }
}

🛠 使用方法

検索ツール

サーバーは、次のパラメーターを指定できる強力な検索ツールを提供します：

{
  "query": string,          // Search query
  "numResults"?: number,    // Number of results (default: 10, max: 100)
  "gl"?: string,           // Country code (e.g., "us", "uk")
  "hl"?: string,           // Language code (e.g., "en", "es")
  "autocorrect"?: boolean, // Enable autocorrect (default: true)
  "type"?: "search"        // Search type (more types coming soon)
}

Deep Research ツール

より包括的なリサーチが必要な場合、サーバーは次のパラメーターを指定できる、複数段階のリサーチを実行する Deep Research ツールを提供します：

{
  "query": string,          // Research query or question
  "depth"?: "basic" | "standard" | "deep",  // Research depth (default: "standard")
  "maxSources"?: number     // Maximum sources to include (default: 10)
}

Deep Research ツールは次の処理を行います：

• 複雑なクエリを、焦点を絞ったサブクエリに分解します
• 複数の検索を実行し、包括的な情報を収集します
• AI を使用して、複数の情報源から情報を統合します
• 適切な引用と参照を付けて結果を整形します
• 中間結果に基づいてリサーチ戦略を調整します
• 検索結果の改善に役立てるため、匿名の品質指標を収集します

深度レベル：

• basic：概要をすばやく把握（情報源 3～5 件、約 5 分） おすすめ：簡単な事実、手短な定義、わかりやすい質問
• standard：包括的な分析（情報源 5～10 件、約 10 分） おすすめ：一般的なリサーチ。深さと速度のバランスを重視する場合
• deep：徹底的なリサーチ（情報源 10 件以上、約 15～20 分） おすすめ：複雑なトピック、学術研究、詳細な分析

検索ツールの応答例

検索結果には豊富なデータが含まれます：

{
  "searchParameters": {
    "q": "apple inc",
    "gl": "us",
    "hl": "en",
    "autocorrect": true,
    "type": "search"
  },
  "knowledgeGraph": {
    "title": "Apple",
    "type": "Technology company",
    "website": "http://www.apple.com/",
    "description": "Apple Inc. is an American multinational technology company...",
    "attributes": {
      "Headquarters": "Cupertino, CA",
      "CEO": "Tim Cook (Aug 24, 2011–)",
      "Founded": "April 1, 1976, Los Altos, CA"
    }
  },
  "organic": [
    {
      "title": "Apple",
      "link": "https://www.apple.com/",
      "snippet": "Discover the innovative world of Apple...",
      "position": 1
    }
  ],
  "peopleAlsoAsk": [
    {
      "question": "What does Apple Inc mean?",
      "snippet": "Apple Inc., formerly Apple Computer, Inc....",
      "link": "https://www.britannica.com/topic/Apple-Inc"
    }
  ],
  "relatedSearches": [
    {
      "query": "Who invented the iPhone"
    }
  ]
}

🔍 応答の種類

ナレッジグラフ

利用可能な場合、エンティティ情報が含まれます：

• タイトルと種類
• ウェブサイトの URL
• 説明
• 主な属性

オーガニック検索結果

次の情報を含む検索結果の一覧です：

• タイトルと URL
• スニペット（説明）
• 検索結果内の順位
• 利用可能な場合はサイトリンク

他の人はこちらも質問

検索に関連するよくある質問：

• 質問文
• 回答のスニペット
• 情報源へのリンク

関連検索

ユーザーがよく検索する、関連クエリの一覧です。

📊 品質指標

Deep Research ツールには、品質指標が統合されています：

• リサーチプロセスの指標
• パフォーマンスの監視
• 問題の追跡
• 使用パターン
• 結果の品質指標

検索品質の改善に役立てるために収集される指標の詳細については、TELEMETRY.md をご覧ください。

🤝 貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

📝 ライセンス

このプロジェクトは MIT ライセンスのもとでライセンスされています。詳しくは LICENSE ファイルをご覧ください。

🙏 謝辞

• Google 検索機能を提供している Serper API
• MCP フレームワークを提供している Model Context Protocol
• 分析機能を提供している PostHog