DuckDuckGo Search MCP 🔍

DuckDuckGo Search MCP 🔍

site icon
2025.04.15 3
JavaScript网络搜索内容提取元数据提取搜索工具
DuckDuckGo Search MCP 是一个基于 Model Context Protocol (MCP) 标准的快速、隐私友好的网络搜索和 URL 内容提取服务。它通过 DuckDuckGo 提供网页搜索、URL 内容提取和元数据提取功能,无需 API 密钥即可使用。
View on GitHub

Overview

基本能力

产品定位

DuckDuckGo Search MCP 是一个隐私友好的网络搜索和内容提取工具,适用于需要快速获取网页内容或进行网络搜索的场景。

核心功能

  • 🌐 使用 DuckDuckGo HTML 进行网页搜索
  • 📄 带有智能过滤的 URL 内容提取
  • 📊 URL 元数据提取(标题、描述、图片)
  • ⚡ 通过缓存优化性能
  • 🛡️ 安全功能,包括速率限制和轮换用户代理
  • 🔌 符合 MCP 标准的服务器实现
  • 🆓 无需 API 密钥,开箱即用

适用场景

  • 需要快速获取网页内容的开发者
  • 需要集成网络搜索功能的 AI 助手
  • 需要提取网页元数据的应用程序

工具列表

  1. 🔍 Web Search Tool (web-search)
  2. 功能:执行网络搜索
  3. 参数:

    • query (string, required): 搜索查询
    • page (integer, optional, default: 1): 页码
    • numResults (integer, optional, default: 10): 结果数量 (1-20)
  4. 📄 Fetch URL Tool (fetch-url)

  5. 功能:提取 URL 内容
  6. 参数:

    • url (string, required): 要提取的 URL
    • maxLength (integer, optional, default: 10000): 最大内容长度
    • extractMainContent (boolean, optional, default: true): 提取主要内容
    • includeLinks (boolean, optional, default: true): 包含链接文本
    • includeImages (boolean, optional, default: true): 包含图片 alt 文本
    • excludeTags (array, optional): 要排除的标签
  7. 📊 URL Metadata Tool (url-metadata)

  8. 功能:提取 URL 元数据
  9. 参数:
    • url (string, required): 要提取元数据的 URL

常见问题解答

  • Q: 是否需要 API 密钥? A: 不需要,该工具开箱即用。
  • Q: 如何与 MCP 客户端集成? A: 在 MCP 客户端配置中添加服务器信息即可。

使用教程

使用依赖

  • Node.js 环境

安装教程

  1. 全局安装
npm install -g @oevortex/ddg_search

运行:

ddg-search-mcp
  1. 本地安装(开发)
git clone https://github.com/OEvortex/ddg_search.git
cd ddg_search
npm install
npm start
  1. 快速启动(无需安装)
npx -y @oevortex/ddg_search

调试方式

  • 检查版本:
npx -y @oevortex/ddg_search --version
  • 查看帮助:
npx -y @oevortex/ddg_search --help

与 MCP 客户端集成

在 MCP 客户端配置中添加:

{
  "mcpServers": {
    "ddg-search": {
      "command": "npx",
      "args": ["-y", "@oevortex/ddg_search"]
    }
  }
}

或(全局安装时):

{
  "mcpServers": {
    "ddg-search": {
      "command": "ddg-search-mcp"
    }
  }
}

许可证

该项目遵循 Other 开源许可条款,请参阅 Other 了解完整条款。