ウェブ検索MCPサーバー

API キーを必要とせず、Google 検索結果を使用して無料の Web 検索を可能にする Model Context Protocol (MCP) サーバー。

特徴

npm install

npm run build

VSCode (Claude Dev Extension) の場合:

{
  "mcpServers": {
    "web-search": {
      "command": "node",
      "args": ["/path/to/web-search/build/index.js"]
    }
  }
}

Claude Desktopの場合:

{
  "mcpServers": {
    "web-search": {
      "command": "node",
      "args": ["/path/to/web-search/build/index.js"]
    }
  }
}

サーバーは、次のパラメータを受け入れるsearchという名前の単一のツールを提供します。

{
  "query": string,    // The search query
  "limit": number     // Optional: Number of results to return (default: 5, max: 10)
}

使用例:

use_mcp_tool({
  server_name: "web-search",
  tool_name: "search",
  arguments: {
    query: "your search query",
    limit: 3  // optional
  }
})

応答例:

[
  {
    "title": "Example Search Result",
    "url": "https://example.com",
    "description": "Description of the search result..."
  }
]

このツールは Google 検索結果の Web スクレイピングを使用するため、注意すべき重要な制限がいくつかあります。

レート制限：短時間に検索が多すぎる場合、Google はリクエストを一時的にブロックすることがあります。これを回避するには、次の手順を実行してください。
- 検索頻度を適度に保つ
- 制限パラメータを慎重に使用する
- 必要に応じて検索間に遅延を設けることを検討してください
結果の精度:
- このツールはGoogleのHTML構造に依存しており、変更される可能性があります。
- 一部の結果には説明やその他のメタデータが欠落している可能性があります
- 複雑な検索演算子は期待通りに動作しない可能性があります
法的考慮事項:
- このツールは個人使用を目的としています
- Googleの利用規約を尊重する
- ユースケースに応じて適切なレート制限を実装することを検討してください

問題や機能強化のリクエストをお気軽にお寄せください。