Duck Duck MCP

🚀 鸭子duck MCP 服务器

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

🚀 快速开始

这是一个 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 许可证。