DuckDuckGo Search MCP 🔍

<div align="center">
  <img src="https://img.shields.io/npm/v/@oevortex/ddg_search.svg" alt="npm version" />
  <img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="License: Apache 2.0" />
  <img src="https://img.shields.io/badge/YouTube-%40OEvortex-red.svg" alt="YouTube Channel" />
  <h1>DuckDuckGo 搜索 MCP 🔍</h1>
  <p>一个快速、注重隐私的模型上下文协议 (MCP) 服务器，使用 DuckDuckGo 进行网络搜索和 URL 内容提取。</p>
  <a href="https://youtube.com/@OEvortex"><strong>订阅以获取更新和教程</strong></a>
</div>

---

> [!IMPORTANT]
> DuckDuckGo 搜索 MCP 支持模型上下文协议 (MCP) 标准，使其与各种 AI 助手和工具兼容。

---

## ✨ 特性

<div style="display: flex; flex-wrap: wrap; gap: 1.5em; margin-bottom: 1.5em;">
  <div><b>🌐 网络搜索</b> 使用 DuckDuckGo HTML</div>
  <div><b>📄 URL 内容提取</b> 具有智能过滤</div>
  <div><b>📊 URL 元数据提取</b> (标题、描述、图像)</div>
  <div><b>⚡ 性能优化</b> 具有缓存</div>
  <div><b>🛡️ 安全特性</b> 包括速率限制和轮换用户代理</div>
  <div><b>🔌 符合 MCP</b> 的服务器实现</div>
  <div><b>🆓 无需 API 密钥</b> - 开箱即用</div>
</div>

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

---

## 🚀 快速开始

<div style="background: #222; color: #fff; padding: 1.5em; border-radius: 8px; margin: 1.5em 0;">
<b>使用 npx 立即运行：</b>

```bash
npx -y @oevortex/ddg_search

</div>

[!TIP] 这将直接下载并运行 MCP 服务器，无需安装 - 非常适合与 AI 助手快速使用。

---

🛠️ 安装选项

<details> <summary><b>全局安装</b></summary>

npm install -g @oevortex/ddg_search

全局运行：

ddg-search-mcp

</details>

<details> <summary><b>本地安装（开发）</b></summary>

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

</details>

---

🧑‍💻 命令行选项

npx -y @oevortex/ddg_search --help

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

---

🤖 与 MCP 客户端一起使用

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

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

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

或者如果全局安装：

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

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

---

🧰 工具概述

<div style="display: flex; flex-wrap: wrap; gap: 2.5em; margin: 1.5em 0;"> <div style="margin-bottom: 1.5em;"> <b>🔍 网络搜索工具</b><br/> <code>web-search</code><br/> <ul> <li><b>query</b> (string, required): 搜索查询</li> <li><b>page</b> (integer, optional, default: 1): 页码</li> <li><b>numResults</b> (integer, optional, default: 10): 结果数量 (1-20)</li> </ul> <i>示例：在网络上搜索“气候变化解决方案”</i> </div> <div style="margin-bottom: 1.5em;"> <b>📄 获取 URL 工具</b><br/> <code>fetch-url</code><br/> <ul> <li><b>url</b> (string, required): 要获取的 URL</li> <li><b>maxLength</b> (integer, optional, default: 10000): 最大内容长度</li> <li><b>extractMainContent</b> (boolean, optional, default: true): 提取主要内容</li> <li><b>includeLinks</b> (boolean, optional, default: true): 包括链接文本</li> <li><b>includeImages</b> (boolean, optional, default: true): 包括图像 alt 文本</li> <li><b>excludeTags</b> (array, optional): 要排除的标签</li> </ul> <i>示例：从“https://example.com”获取内容</i> </div> <div style="margin-bottom: 1.5em;"> <b>📊 URL 元数据工具</b><br/> <code>url-metadata</code><br/> <ul> <li><b>url</b> (string, required): 要从中提取元数据的 URL</li> </ul> <i>示例：获取“https://example.com”的元数据</i> </div> </div>

---

📁 项目结构

bin/              # 命令行界面
src/
  index.js        # 主要入口点
  tools/          # 工具定义和处理程序
    searchTool.js
    fetchUrlTool.js
    metadataTool.js
  utils/
    search.js     # 搜索和 URL 实用程序
package.json
README.md

---

🤝 贡献

欢迎贡献！请打开 issue 或提交 pull request。

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

---

📺 YouTube 频道

<div align="center"> <a href="https://youtube.com/@OEvortex"><img src="https://img.shields.io/badge/YouTube-%40OEvortex-red.svg" alt="YouTube Channel" /></a> <br/> <a href="https://youtube.com/@OEvortex">youtube.com/@OEvortex</a> </div>

---

📄 许可证

Apache License 2.0

[!NOTE] 本项目根据 Apache License 2.0 获得许可 – 有关详细信息，请参阅 <a href="LICENSE">LICENSE</a> 文件。

---

<div align="center"> _{用 ❤️ 由 <a href="https://youtube.com/@OEvortex">@OEvortex</a> 制作} </div>