DuckDuckGo MCP Server

A Model Context Protocol (MCP) server that enables AI assistants to perform real-time web searches using DuckDuckGo.

Features

• Web Search: Search the web with DuckDuckGo
• Content Fetching: Extract clean content from web pages
• Search Suggestions: Get related search suggestions
• Dual Mode: stdio (local) and HTTP (remote) support
• Rate Limiting: Built-in protection against abuse

Quick Start

Local Setup (Claude Desktop)

1. Install dependencies:

python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

1. Configure Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "duckduckgo-search": {
      "command": "/path/to/venv/bin/python",
      "args": ["/path/to/run_mcp_server.py"]
    }
  }
}

Configuration

Legal Notice

This software uses an DuckDuckGo scraping library.

For Educational Use Only:

• Personal learning and research
• Local development and testing
• Commercial use or production deployments
• High-volume automated searches

No Warranty: Use at your own risk. The author assumes no liability.

Commercial Alternatives:

• Bing Search API - 1,000 free queries/month
• Google Custom Search API - 100 free queries/day
• Brave Search API

License