988664li-star/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

# 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