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

# 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:

# 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:

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