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

2. 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