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)
- Install dependencies:
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
- 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
| Option | Default | Description |
|---|---|---|
mode | "http" | "stdio" for local, "http" for remote |
port | 3000 | HTTP port (http mode only) |
searchRateLimit | 30 | Max searches per minute |
maxResultsDefault | 10 | Default number of results |
⚠️ 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