DuckDuckGo Web Search MCP Server

DuckDuckGo 网页搜索 MCP 服务

本项目提供一个 MCP（Model Context Protocol）服务，可使用 DuckDuckGo 搜索引擎搜索网页，并可选择获取和总结找到的网址内容。

功能

• 网页搜索： 使用 DuckDuckGo 搜索网页。
• 结果提取： 从搜索结果中提取标题、URL 和摘要。
• 内容获取（可选）： 获取搜索结果中找到的网址内容，并使用 jina api 将其转换为 Markdown 格式。
• 并行获取： 并发获取多个 URL，以加快处理速度。
• 错误处理： 妥善处理搜索和获取过程中的超时及其他潜在错误。
• 可配置： 可设置要返回的搜索结果数量上限。
• Jina API：使用 jina api 将 HTML 转换为 Markdown。
• 兼容 MCP：此服务旨在与任何兼容 MCP 的客户端配合使用。

使用方法

1. 前置条件：

   • uvx 包管理器

2. Claude Desktop 配置

   • 如果你使用 Claude Desktop，可以将服务添加到 claude_desktop_config.json 文件中。

   {
       "mcpServers": {
           "web-search-duckduckgo": {
               "command": "uvx",
               "args": [
                   "--from",
                   "git+https://github.com/kouui/web-search-duckduckgo.git@main",
                   "main.py"
               ]
           }
       }
   }
   

   以上配置无法正常工作时，你可能需要将代码库克隆到本地电脑，并使用以下配置

   {
       "mcpServers": {
           "web-search-duckduckgo": {
               "command": "uv",
               "args": [
                   "--directory",
                   "/path/to/web-search-duckduckgo",
                   "run",
                   "main.py"
               ]
           }
       }
   }
   

3. 工具

   • 现在，你可以在 MCP 客户端（例如 Claude）中使用以下工具：

   • search_and_fetch： 搜索网页并获取网址内容。

     • query：搜索查询字符串。
     • limit：要返回的结果数量上限（默认值：3，最大值：10）。

   • fetch： 获取指定 URL 的内容。

     • url：要获取的 URL。

许可证

本项目采用 MIT 许可证。（如果要指定许可证，请添加许可证文件）。