返回 MCP 目录
public公开dns本地运行

duck-duck-mcp

一个基于DuckDuckGo搜索引擎的MCP服务器实现,提供结构化搜索、智能分类和语言检测功能,支持与AI客户端集成。

article

README

🚀 鸭子duck MCP 服务器

这是一个基于 DuckDuckGo 搜索引擎的 Model Context Protocol (MCP) 服务器实现,可借助 DuckDuckGo 进行网络搜索,为支持 MCP 协议的 AI 客户端(如 Claude)提供结构化搜索结果。

smithery badge

🚀 快速开始

这是一个 MCP 服务器实现,主要用于与支持 MCP 协议的 AI 客户端(如 Claude)集成。使用前,你可以通过以下方式进行安装和启动。

✨ 主要特性

  • 使用 DuckDuckGo 进行网络搜索。
  • 支持自定义搜索结果数量(默认 50 条)。
  • 支持区域设置(默认 zh-cn)。
  • 支持安全搜索级别设置(OFF/MODERATE/STRICT)。
  • 提供结构化的搜索结果,包含元数据。
  • 智能内容分类(文档/文章/社交媒体)。
  • 自动语言检测。
  • 主题标签识别。

📦 安装指南

通过 Smithery 安装

通过 Smithery 将 DuckDuckGo 搜索自动安装到 Claude 桌面端:

npx -y @smithery/cli install duck-duck-mcp --client claude

不需要安装,可以直接通过 npx 运行:

npx -y @smithery/cli install duck-duck-mcp --client claude

启动服务器

# 使用 npx(推荐)
npx duck-duck-mcp

# 或者如果已经全局安装
mcp-server-search

💻 使用示例

基础用法

以下是搜索参数示例:

{
  "query": "搜索关键词",
  "options": {
    "region": "zh-cn",
    "safeSearch": "MODERATE",
    "numResults": 50
  }
}

高级用法

服务器返回结果格式如下:

{
  "type": "search_results",
  "data": [
    {
      "title": "标题",
      "url": "网址",
      "description": "描述",
      "metadata": {
        "type": "article|documentation|social|other",
        "source": "域名"
      }
    }
  ],
  "metadata": {
    "query": "搜索关键词",
    "timestamp": "时间戳",
    "resultCount": 50,
    "searchContext": {
      "region": "zh-cn",
      "safeSearch": "MODERATE"
    },
    "queryAnalysis": {
      "language": "zh-cn|en",
      "topics": ["technology", "documentation"]
    }
  }
}

📄 许可证

本项目采用 MIT 许可证。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端