DuckDuckGo MCP Server is a web search integration that enables AI assistants to query DuckDuckGo and extract content from websites. It provides real-time access to search results with configurable safety filters and region settings. Key features of DuckDuckGo MCP Server: - Query DuckDuckGo web search with regional and SafeSearch configuration (Off, Moderate, or Strict) - Fetch and parse webpage content using intelligent text extraction - Built-in rate limiting to prevent search throttling and ensure stable operations - LLM-optimized output formatting designed for large language model consumption - Comprehensive error handling and logging for reliable search operations

DuckDuckGo Search MCP Server

[](https://pypi.org/project/duckduckgo-mcp-server/) [](https://pypi.org/project/duckduckgo-mcp-server/) [](https://pypi.org/project/duckduckgo-mcp-server/)

A Model Context Protocol (MCP) server that provides web search capabilities through DuckDuckGo, with additional features for content fetching and parsing.

Quick Start

uvx duckduckgo-mcp-server

Features

Installation

Install from PyPI using uv:

uv pip install duckduckgo-mcp-server

Usage

Running with Claude Desktop

1. Download Claude Desktop 2. Create or edit your Claude Desktop configuration: - On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - On Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the following configuration:

Basic Configuration (No SafeSearch, No Default Region):

{
    "mcpServers": {
        "ddg-search": {
            "command": "uvx",
            "args": ["duckduckgo-mcp-server"]
        }
    }
}

With SafeSearch and Region Configuration:

{
    "mcpServers": {
        "ddg-search": {
            "command": "uvx",
            "args": ["duckduckgo-mcp-server"],
            "env": {
                "DDG_SAFE_SEARCH": "STRICT",
                "DDG_REGION": "cn-zh"
            }
        }
    }
}

Configuration Options:

3. Restart Claude Desktop

Running with Claude Code

1. Download Claude Code 2. Ensure uvenv is installed and the uvx command is available 3. Add the MCP server: claude mcp add ddg-search uvx duckduckgo-mcp-server

Running with SSE or Streamable HTTP

The server supports alternative transports for use with other MCP clients:

# SSE transport
uvx duckduckgo-mcp-server --transport sse
Streamable HTTP transport
uvx duckduckgo-mcp-server --transport streamable-http

The default transport is stdio, which is used by Claude Desktop and Claude Code.

Development

For local development:

# Install dependencies
uv sync
Run with the MCP Inspector
mcp dev src/duckduckgo_mcp_server/server.py
Install locally for testing with Claude Desktop
mcp install src/duckduckgo_mcp_server/server.py
Run all tests
uv run python -m pytest src/duckduckgo_mcp_server/ -v
Run only unit tests
uv run python -m pytest src/duckduckgo_mcp_server/test_server.py -v
Run only e2e tests
uv run python -m pytest src/duckduckgo_mcp_server/test_e2e.py -v

Available Tools

1. Search Tool

async def search(query: str, max_results: int = 10, region: str = "") -> str

Performs a web search on DuckDuckGo and returns formatted results.

Parameters:

Region Code Examples:

Returns: Formatted string containing search results with titles, URLs, and snippets.

Example Usage:

2. Content Fetching Tool

async def fetch_content(url: str) -> str

Fetches and parses content from a webpage.

Parameters:

Returns: Cleaned and formatted text content from the webpage.

Features in Detail

Rate Limiting