DuckDuckGo MCP Server

# 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](https://github.com/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: ```bash make ``` Or directly with Docker/Podman: ```bash docker build -t ddg-mcp-server:0.1.0 . ``` ## Running Run the container exposing port 9870: ```bash 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)