DuckDuckGo MCP Server

# DuckDuckGo MCP Server A Model Context Protocol (MCP) server that provides web search capabilities through DuckDuckGo with content fetching features. ## Features - **Web Search**: Search DuckDuckGo with advanced rate limiting and result formatting - **Content Fetching**: Retrieve and parse webpage content with intelligent text extraction - **Rate Limiting**: Built-in protection against rate limits - **LLM-Friendly Output**: Results formatted specifically for large language model consumption ## Docker Build ```bash # Build the Docker image docker build -t duckduckgo-mcp-server:latest . # Run the MCP server docker run --rm -i duckduckgo-mcp-server:latest ``` ## Aliyun Image The image is also available on Aliyun Container Registry: ```bash # Pull from Aliyun docker pull crpi-kdbkl9428esejpsc.cn-hangzhou.personal.cr.aliyuncs.com/li-personal/duckduckgo-mcp-server:latest # Run the Aliyun image docker run --rm -i crpi-kdbkl9428esejpsc.cn-hangzhou.personal.cr.aliyuncs.com/li-personal/duckduckgo-mcp-server:latest ``` ## MCP Tools ### search Search DuckDuckGo and return formatted results. - **query**: Search query string - **max_results**: Maximum number of results (default: 10) ### fetch_content Fetch and parse content from a webpage URL. - **url**: The webpage URL to fetch content from ## Claude Code Integration Add to Claude Code global configuration: ```bash claude mcp add --scope user --transport stdio duckduckgo-search -- docker run --rm -i crpi-kdbkl9428esejpsc.cn-hangzhou.personal.cr.aliyuncs.com/li-personal/duckduckgo-mcp-server:latest ``` ## Project Structure ``` . ├── Dockerfile # Docker build configuration ├── docker-compose.yml # Docker Compose configuration ├── pyproject.toml # Python project configuration ├── .dockerignore # Docker build ignore rules └── src/ └── duckduckgo_mcp_server/ ├── __init__.py # Package initialization └── server.py # Main MCP server implementation ```