O

OEvortex

web-scrapingsearchbrowser-automation

476 查看 · 2026-07-07 更新

npm version License: Apache 2.0 YouTube Channel

DuckDuckGo & Felo AI 搜索 MCP 🔍🧠

使用 DuckDuckGo 和 Felo AI 进行网页搜索和基于 AI 的响应的快速且注重隐私的 Model Context Protocol (MCP) 服务器。

DuckDuckGo Search MCP 服务器 订阅以获取更新和教程

[!IMPORTANT] DuckDuckGo 搜索 MCP 支持 Model Context Protocol (MCP) 标准,使其与各种 AI 助手和工具兼容。


✨ 特性

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

[!IMPORTANT] 与许多搜索工具不同,此包执行实际的网页抓取而不是使用有限的 API,为您提供更全面的结果。


🚀 快速开始

使用 npx 即刻运行:

bash npx -y @oevortex/ddg_search@latest

[!TIP] 这将直接下载并运行最新版本的 MCP 服务器,而无需安装——非常适合与 AI 助手快速使用。


🛠️ 安装选项

全局安装

bash npm install -g @oevortex/ddg_search

全局运行:

bash ddg-search-mcp

本地安装(开发)

bash git clone https://github.com/OEvortex/ddg_search.git cd ddg_search npm install npm start


🧑‍💻 命令行选项

bash npx -y @oevortex/ddg_search@latest --help

[!TIP] 使用 --version 标志来检查您正在运行的版本。


🤖 与 MCP 客户端一起使用

[!IMPORTANT] 使用此工具最常见的方法是将其与支持 MCP 的 AI 助手集成。

将服务器添加到您的 MCP 客户端配置中:

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

如果已全局安装:

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

[!TIP] 配置后,请重启您的 MCP 客户端以应用更改。


🧰 工具概述

🔍 网页搜索工具
web-search
  • query (字符串, 必填): 搜索查询
  • page (整数, 可选, 默认: 1): 页码
  • numResults (整数, 可选, 默认: 10): 结果数量 (1-20)
示例:搜索“climate change solutions”
🧠 Felo AI 搜索工具
felo-search
  • query (字符串, 必填): 搜索查询或提示
  • stream (布尔值, 可选, 默认: false): 是否流式传输响应
示例:在Felo AI中搜索“用简单的术语解释量子计算”
📄 获取URL工具
fetch-url
  • url (字符串, 必须): 要获取的URL
  • maxLength (整数, 可选, 默认: 10000): 最大内容长度
  • extractMainContent (布尔值, 可选, 默认: true): 提取主要内容
  • includeLinks (布尔值, 可选, 默认: true): 包含链接文本
  • includeImages (布尔值, 可选, 默认: true): 包含图片替代文本
  • excludeTags (数组, 可选): 需要排除的标签
示例:从"https://example.com"获取内容
📊 URL元数据工具
url-metadata
  • url (字符串, 必须): 要从中提取元数据的URL
示例:获取"https://example.com"的元数据

📁 项目结构

text bin/ # 命令行接口 src/ index.js # 主入口点 tools/ # 工具定义和处理器 searchTool.js fetchUrlTool.js metadataTool.js feloTool.js utils/ search.js # 搜索和URL实用程序 search_felo.js # Felo AI搜索实用程序 package.json README.md


🤝 贡献

欢迎贡献!请提出问题或提交拉取请求。

[!NOTE] 请遵循现有的代码风格,并为新功能添加测试。


📺 YouTube频道


📄 许可证

Apache许可证2.0

[!NOTE] 本项目根据Apache许可证2.0授权 - 查看LICENSE文件了解详情。


@OEvortex用心制作

工具列表

  • web-search: Search the web using DuckDuckGo and return results

  • fetch-url: Fetch the content of a URL and return it as text, with options to control extraction

  • url-metadata: Extract metadata from a URL (title, description, etc.)

  • felo-search: Search the web for up-to-date technical information like latest releases, security advisories, migration guides, benchmarks, and community insights

服务配置

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

来源