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 的服務條款。
   • 考慮為您的用例實現適當的速率限制。

🤝 貢獻指南

歡迎提交問題和改進請求！