Websearch

🚀 網絡搜索指南

WebSearch MCP服務器是一款用於執行網絡搜索的工具，支持多語言搜索、區域限制、排除特定域名等高級功能，能為用戶提供精準、高效的搜索服務。以下是詳細的使用指南。

🚀 快速開始

使用Docker運行服務

您可以使用以下命令快速啟動WebSearch MCP服務器：

docker-compose up --build

此命令會構建並運行所有必要的容器，包括WebSearch服務和FlareSolverr（用於處理反垃圾驗證）。

手動安裝

1. 克隆倉庫：

git clone <repository-url>
cd websearch-mcp-server

2. 安裝依賴項：

npm install

3. 啟動開發模式：

npm run dev

✨ 主要特性

• 多語言支持：根據指定的語言返回搜索結果。
• 區域限制：可以根據地區代碼過濾結果。
• 排除域名：指定要排除的域名，避免顯示特定網站的內容。
• 多種結果類型：支持“all”、“news”和“blogs”三種結果類型。

示例響應

{
  "query": "機器學習趨勢",
  "results": [
    {
      "title": "2025年人工智能發展趨勢",
      "snippet": "2025年關鍵的人工智能趨勢包括多模態AI、生成模型和量子人工智能在企業中的應用...",
      "url": "https://example.com/ml-trends-2025",
      "siteName": "人工智能研究今日",
      "byline": "簡·史密斯博士"
    },
    {
      "title": "機器學習五年演變歷程：2020-2025",
      "snippet": "過去五年，機器學習從監督學習方法發展到更復雜的自監督和強化學習範式...",
      "url": "https://example.com/ml-evolution",
      "siteName": "科技洞察",
      "byline": "約翰·多伊"
    }
  ]
}

💻 使用示例

作為命令行工具

運行以下命令啟動MCP服務器：

npm run start

然後使用提供的測試客戶端與服務器交互：

npm run test-client

作為庫

您可以將此包程序化地使用：

import { createMCPClient } from '@modelcontextprotocol/sdk';

// 創建MCP客戶端
const client = createMCPClient({
  transport: { type: 'subprocess', command: 'npx websearch-mcp' }
});

// 執行網絡搜索
const response = await client.request({
  method: 'call_tool',
  params: {
    name: 'web_search',
    arguments: {
      query: '您的搜索詞',
      numResults: 5,
      language: 'zh'
    }
  }
});

console.log(response.result);

🔧 技術細節

故障排除

網絡搜索服務問題

• 錯誤信息：檢查是否有任何錯誤日誌輸出。
• 反垃圾驗證：確保FlareSolverr正常運行。

開發問題

• 依賴項缺失：如果安裝失敗，請重新運行npm install。
• 構建失敗：檢查項目中的package.json文件是否完整。

項目結構

websearch-mcp-server/
├── src/                 # 源代碼目錄
│   ├── index.js       # 入口文件
│   └── server.js      # 服務器配置
├── package.json       # 依賴項和腳本
└── docker-compose.yml # Docker配置文件

發佈npm包

1. 更新package.json中的版本號。
2. 提交更改：

git add .
git commit -m "更新版本"

3. 打包併發布：

npm pack
npm publish

🤝 貢獻指南

• 請 fork 倉庫並在您的分支上進行開發。
• 提交Pull Request前，請確保代碼通過所有測試。

感謝使用WebSearch MCP服務器！如果有任何問題，請隨時聯繫維護團隊。