Web Scout MCP Server

Web Scout MCP 服务

一个用于网页搜索和内容提取的 MCP 服务，使用 DuckDuckGo，支持多个 URL 和内存优化。

✨ 功能

• 🔍 DuckDuckGo 搜索：快速且注重隐私的网页搜索功能
• 📄 内容提取：从网页中提取整洁、易读的文本
• 🚀 并行处理：支持同时从多个 URL 提取内容
• 💾 内存优化：智能内存管理，防止应用崩溃
• ⏱️ 速率限制：智能限制请求频率，避免 API 封锁
• 🛡️ 错误处理：可靠运行所需的稳健错误处理

📦 安装

通过 Smithery 安装

通过 Smithery 自动为 Claude Desktop 安装 Web Scout：

npx -y @smithery/cli install @pinkpixel-dev/web-scout-mcp --client claude

全局安装

npm install -g @pinkpixel/web-scout-mcp

本地安装

npm install @pinkpixel/web-scout-mcp

🚀 使用方法

命令行

全局安装后，运行：

web-scout-mcp

使用 MCP 客户端

将以下内容添加到 MCP 客户端的 config.json 中（Claude Desktop、Cursor 等）：

{
  "mcpServers": {
    "web-scout": {
      "command": "npx",
      "args": [
        "-y",
        "@pinkpixel/web-scout-mcp@latest"
      ]
    }
  }
}

环境变量

在嵌入此软件包并自行调用 createServer() 时，设置环境变量 WEB_SCOUT_DISABLE_AUTOSTART=1。默认情况下，运行已发布的入口点（例如 node dist/index.js 或 npx @pinkpixel/web-scout-mcp）会自动启动 stdio 传输。

🧰 工具

该服务提供以下 MCP 工具：

🔍 DuckDuckGoWebSearch

使用 DuckDuckGo 搜索引擎发起网页搜索，并返回结构清晰的结果列表。

输入：

• query（string）：搜索查询字符串
• maxResults（number，可选）：要返回的最大结果数（默认值：10）

示例：

{
  "query": "latest advancements in AI",
  "maxResults": 5
}

输出： 格式化的搜索结果列表，包含标题、URL 和摘要。

📄 UrlContentExtractor

从网页中获取并提取整洁、易读的内容，移除脚本、样式和导航等不必要的元素。

输入：

• url：单个 URL 字符串或 URL 字符串数组

示例（单个 URL）：

{
  "url": "https://example.com/article"
}

示例（多个 URL）：

{
  "url": [
    "https://example.com/article1",
    "https://example.com/article2"
  ]
}

输出： 从指定 URL 提取的文本内容。

🛠️ 开发

# Clone the repository
git clone https://github.com/pinkpixel-dev/web-scout-mcp.git
cd web-scout-mcp

# Install dependencies
npm install

# Build
npm run build

# Run
npm start

📚 文档

如需了解项目的详细信息，请参阅以下资源：

• OVERVIEW.md - 技术概览和架构
• CONTRIBUTING.md - 贡献指南
• CHANGELOG.md - 版本历史和变更

📋 要求

• Node.js >= 18.0.0
• npm 或 yarn

📄 许可证

本项目采用 Apache 2.0 License 授权。

_{由 Pink Pixel 倾心打造 ❤️
✨ 梦想成真，像素绘就 ✨}