Duck Duck MCP

🚀 Duck Duck MCP Server

This is an implementation of the Model Context Protocol (MCP) server based on the DuckDuckGo search engine.

✨ Features

• Conduct web searches using DuckDuckGo.
• Support customizing the number of search results (default is 50).
• Support region settings (default is zh-cn).
• Support setting the safe search level (OFF/MODERATE/STRICT).
• Provide structured search results with metadata.
• Perform intelligent content classification (documents/articles/social media).
• Automatically detect languages.
• Identify topic tags.

📦 Installation

Install via Smithery

Automatically install DuckDuckGo search to the Claude desktop via Smithery:

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

You can also run it directly via npx without installation:

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

💻 Usage Examples

How to Use

This is an MCP server implementation, mainly used for integration with AI clients that support the MCP protocol (such as Claude).

Start the Server:

# Use npx (recommended)
npx duck-duck-mcp

# Or if globally installed
mcp-server-search

Example of Search Parameters:

{
  "query": "Search keywords",
  "options": {
    "region": "zh-cn",
    "safeSearch": "MODERATE",
    "numResults": 50
  }
}

Format of Returned Results:

{
  "type": "search_results",
  "data": [
    {
      "title": "Title",
      "url": "URL",
      "description": "Description",
      "metadata": {
        "type": "article|documentation|social|other",
        "source": "Domain name"
      }
    }
  ],
  "metadata": {
    "query": "Search keywords",
    "timestamp": "Timestamp",
    "resultCount": 50,
    "searchContext": {
      "region": "zh-cn",
      "safeSearch": "MODERATE"
    },
    "queryAnalysis": {
      "language": "zh-cn|en",
      "topics": ["technology", "documentation"]
    }
  }
}

📄 License

MIT