# 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:
```bash
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`):
```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](https://www.microsoft.com/en-us/bing/apis/bing-web-search-api) - 1,000 free queries/month
- [Google Custom Search API](https://developers.google.com/custom-search) - 100 free queries/day
- [Brave Search API](https://brave.com/search/api/)
## License