DuckDuckGo

Provides real-time web search, content fetching, and related suggestions via MCP using DuckDuckGo.

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "rkampani-duckduckgo-mcp": {
      "command": "/path/to/venv/bin/python",
      "args": [
        "/path/to/run_mcp_server.py"
      ]
    }
  }
}

DuckDuckGo MCP Server enables AI assistants to perform real-time web searches using DuckDuckGo, fetch clean page content, and provide related search suggestions. It supports local stdio mode for development and HTTP mode for remote usage, with built-in rate limiting to protect against abuse.

How to use

Use the DuckDuckGo MCP Server with an MCP client to query the web, retrieve relevant results, and fetch page content. In local development, run the server from your machine and point your MCP client to the local stdio endpoint. In remote deployments, use the HTTP endpoint provided by your MCP hosting environment.

How to install

# prerequisites
# 1) Ensure Python 3.x is installed
# 2) Optional: create a virtual environment to isolate dependencies

python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Local installation steps culminate in a ready-to-run MCP server script. The README provides the exact commands to create and activate a virtual environment and install dependencies.

# Claude Desktop configuration for local MCP server
{
  "mcpServers": {
    "duckduckgo_search": {
      "command": "/path/to/venv/bin/python",
      "args": ["/path/to/run_mcp_server.py"]
    }
  }
}

Configuration

The server supports both stdio (local) and http (remote) operation. The default mode is http, but you can switch to stdio for local workflows. Key options include the HTTP port, the search rate limit, and the default number of results shown.

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

Notes and security

The MCP server relies on a DuckDuckGo scraping library. Use it for educational and local development purposes only. Avoid commercial deployments or high-volume automated searches unless you have appropriate licenses or API access.

Troubleshooting

If you encounter issues starting the server, verify your Python environment, ensure dependencies are installed, and confirm the path to the Python executable and the MCP server script in your Claude Desktop configuration. Review any error messages for hints about missing modules or permissions.

Examples

For local testing, run the provided commands to create a virtual environment, activate it, install dependencies, and configure Claude Desktop to point to the local MCP server.