Web Search Iur

🚀 ネットワーク検索 MCP サーバー

Model Context Protocol (MCP) サーバーです。Google 検索結果を使用して、API キーを必要とせずに無料でネットワーク検索を行うことができます。

✨ 主な機能

• Google 検索結果を使用したネットワーク検索
• API キーや認証が不要
• タイトル、URL、説明を含む構造化された検索結果を返す
• 検索結果数を設定可能

📦 インストール

1. このリポジトリをクローンまたはダウンロードします。
2. 依存関係をインストールします。

npm install

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

npm run build

4. サーバーを MCP 設定に追加します。

VSCode（Claude Dev 拡張機能）の場合：

{
  "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,    // 検索クエリ
  "limit": number     // オプション：返される結果の数（デフォルト値：5、最大値：10）
}

使用例：

use_mcp_tool({
  server_name: "web-search",
  tool_name: "search",
  arguments: {
    query: "your search query",
    limit: 3  // オプション
  }
})

応答例：

[
  {
    "title": "示例搜索结果",
    "url": "https://example.com",
    "description": "検索結果の説明..."
  }
]

📚 ドキュメント

このツールは Google 検索結果のウェブスクレイピングを使用しているため、以下の重要な制限があります。

⚠️ 重要提示

1. レート制限：短時間に大量の検索を実行すると、Google が一時的にリクエストをブロックする可能性があります。これを避けるために：

   • 適切な検索頻度を維持します。
   • limit パラメータを慎重に使用します。
   • 必要に応じて、検索間に遅延を追加します。

2. 結果の正確性：

   • ツールは Google の HTML 構造に依存しており、これは変更される可能性があります。
   • 一部の結果には説明やその他のメタデータが欠けている場合があります。
   • 複雑な検索演算子は期待通りに動作しない場合があります。

3. 法的な考慮事項：

   • このツールは個人使用を目的としています。
   • Google のサービス利用規約を遵守します。
   • ご使用のケースに適したレート制限を実装することを検討します。

🤝 貢献ガイド

問題の報告や改善要望は大歓迎です！