网络搜索指南

项目概述

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
   

功能概述

WebSearch MCP服务器提供以下功能：

• 多语言支持：根据指定的语言返回搜索结果。
• 区域限制：可以根据地区代码过滤结果。
• 排除域名：指定要排除的域名，避免显示特定网站的内容。
• 多种结果类型：支持“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服务器！如果有任何问题，请随时联系维护团队。