WebSearch-MCP

基本能力

产品定位

WebSearch-MCP 是一个为 AI 助手提供实时网页搜索能力的 MCP 服务器。

核心功能

• 提供网页搜索能力，支持多种搜索参数（如语言、地区、结果类型等）。
• 集成 WebSearch Crawler API 进行实际网页搜索。
• 支持通过 stdio 传输与 AI 助手通信。

适用场景

• AI 助手需要获取实时网络信息时。
• 需要定制化搜索结果的场景（如排除特定域名、限制结果数量等）。

工具列表

• web_search 工具：提供网页搜索功能，支持多种参数配置。

常见问题解答

• API 不可达：确保爬虫服务正在运行并可通过配置的 API_URL 访问。
• 搜索结果不可用：检查爬虫服务的日志以查看是否有错误。
• FlareSolverr 问题：某些网站使用 Cloudflare 保护，检查 FlareSolverr 是否正常工作。

使用教程

使用依赖

• Docker 和 Docker Compose

安装教程

通过 Smithery 安装

npx -y @smithery/cli install @mnhlt/WebSearch-MCP --client claude

手动安装

npm install -g websearch-mcp

或无需安装直接使用：

npx websearch-mcp

调试方式

启动爬虫服务

1. 创建 docker-compose.yml 文件并启动服务：

docker-compose up -d

1. 验证服务是否运行：

docker-compose ps

1. 测试爬虫 API 健康端点：

curl http://localhost:3001/health

测试爬虫 API

curl -X POST http://localhost:3001/crawl \
  -H "Content-Type: application/json" \
  -d '{
    "query": "typescript best practices",
    "numResults": 2,
    "language": "en",
    "filters": {
      "excludeDomains": ["youtube.com"],
      "resultType": "all" 
    }
  }'

测试 MCP 服务器

npm run test-client

或配置 API_URL 进行测试：

API_URL=https://crawler.example.com npm run test-client

许可证

该项目遵循 ISC 开源许可条款。