SerpApi MCPサーバー

SerpApiと統合し、包括的な検索エンジンの結果とデータ抽出を提供するModel Context Protocol (MCP) サーバーの実装です。

機能

• マルチエンジン検索: Google、Bing、Yahoo、DuckDuckGo、YouTube、eBay、その他

• エンジンリソース: MCPリソースを介して利用可能なエンジンごとのパラメータスキーマ（検索ツールを参照）

• リアルタイム天気データ: 検索クエリを介した場所ベースの天気予報

• 株式市場データ: 検索統合を通じた企業財務および市場データ

• 動的な結果処理: さまざまな結果タイプを自動的に検出してフォーマット

• 柔軟なレスポンスモード: 完全またはコンパクトなJSONレスポンス

• JSONレスポンス: 完全またはコンパクトモードを備えた構造化JSON出力

Related MCP server: SearXNG MCP Server

クイックスタート

SerpApi MCPサーバーは、mcp.serpapi.comでホスト型サービスとして利用可能です。接続するには、APIキーを提供する必要があります。APIキーはSerpApiダッシュボードで確認できます。

Claude Desktopがホスト型サーバーを使用するように設定できます：

{
  "mcpServers": {
    "serpapi": {
      "type": "http",
      "url": "https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp"
    }
  }
}

セルフホスティング

git clone https://github.com/serpapi/serpapi-mcp.git
cd serpapi-mcp
uv sync && uv run src/server.py

Claude Desktopの設定：

{
  "mcpServers": {
    "serpapi": {
      "type": "http",
      "url": "http://localhost:8000/YOUR_SERPAPI_API_KEY/mcp"
    }
  }
}

APIキーの取得：serpapi.com/manage-api-key

認証

2つの方法がサポートされています：

• パスベース: /YOUR_API_KEY/mcp（推奨）

• ヘッダーベース: Authorization: Bearer YOUR_API_KEY

例：

# Path-based
curl "https://mcp.serpapi.com/your_key/mcp" -d '...'

# Header-based  
curl "https://mcp.serpapi.com/mcp" -H "Authorization: Bearer your_key" -d '...'

検索ツール

MCPサーバーには、すべてのSerpApiエンジンと結果タイプをサポートするメインの検索ツールが1つあります。利用可能なすべてのパラメータはSerpApi APIリファレンスで確認できます。 エンジンパラメータのスキーマは、MCPリソース serpapi://engines（インデックス）および serpapi://engines/<engine> としても公開されています。

提供できるパラメータは、各APIエンジンに固有のものです。いくつかのサンプルパラメータを以下に示します：

• params.q (必須): 検索クエリ

• params.engine: 検索エンジン (デフォルト: "google_light")

• params.location: 地理的フィルタ

• mode: レスポンスモード - "complete" (デフォルト) または "compact"

• ...その他のパラメータはSerpApi APIリファレンスを参照してください

例：

{"name": "search", "arguments": {"params": {"q": "coffee shops", "location": "Austin, TX"}}}
{"name": "search", "arguments": {"params": {"q": "weather in London"}}}
{"name": "search", "arguments": {"params": {"q": "AAPL stock"}}}
{"name": "search", "arguments": {"params": {"q": "news"}, "mode": "compact"}}
{"name": "search", "arguments": {"params": {"q": "detailed search"}, "mode": "complete"}}

サポートされているエンジン： Google、Bing、Yahoo、DuckDuckGo、YouTube、eBayなど（serpapi://enginesを参照）。

結果タイプ： 回答ボックス、オーガニック検索結果、ニュース、画像、ショッピング - 自動的に検出およびフォーマットされます。

開発

# Local development
uv sync && uv run src/server.py

# Docker
docker build -t serpapi-mcp . && docker run -p 8000:8000 serpapi-mcp

# Regenerate engine resources (Playground scrape)
python build-engines.py

# Testing with MCP Inspector
npx @modelcontextprotocol/inspector
# Configure: URL mcp.serpapi.com/YOUR_KEY/mcp, Transport "Streamable HTTP transport"

トラブルシューティング

• "Missing API key": URLパス /{YOUR_KEY}/mcp またはヘッダー Bearer YOUR_KEY にキーを含めてください

• "Invalid key": serpapi.com/dashboardで確認してください

• "Rate limit exceeded": しばらく待つか、SerpApiプランをアップグレードしてください

• "No results": 別のクエリやエンジンを試してください

コントリビューション

1. リポジトリをフォークする

2. フィーチャーブランチを作成する: git checkout -b feature/amazing-feature

3. 依存関係をインストールする: uv install

4. 変更を加える

5. 変更をコミットする: git commit -m 'Add amazing feature'

6. ブランチにプッシュする: git push origin feature/amazing-feature

7. プルリクエストを開く

ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。