DuckDuckGo MCP Server

A Model Context Protocol (MCP) server that provides DuckDuckGo search capabilities and web content fetching.

Origin

This server was copied from nickclyde/duckduckgo-mcp-server on GitHub.

Copyright (c) 2025 Nick Clyde Released under the MIT License

Features

• Web Search: Search DuckDuckGo and return formatted results
• Content Fetching: Fetch and parse webpage content from URLs
• Rate limiting to prevent overwhelming services
• Runs as an MCP server on port 9870

Building

Build the container using the Makefile:

make

Or directly with Docker/Podman:

docker build -t ddg-mcp-server:0.1.0 .

Running

Run the container exposing port 9870:

docker run -p 9870:9870 ddg-mcp-server:0.1.0

MCP Tools

The server provides two MCP tools:

1. search: Search DuckDuckGo and return formatted results

   • query: The search query string
   • max_results: Maximum number of results to return (default: 10)

2. fetch_content: Fetch and parse content from a webpage URL

   • url: The webpage URL to fetch content from

Dependencies

• Python 3.12
• mcp (Model Context Protocol)
• httpx (async HTTP client)
• beautifulsoup4 (HTML parsing)

CI/CD

The repository includes GitHub Actions workflows for:

• Pull request testing (builds the container)
• Release deployment (builds and pushes to Docker Hub)