Overview
What is ddg-mcp?
ddg-mcp is a Model Context Protocol (MCP) server that provides DuckDuckGo search capabilities — including text, image, news, and video search — plus an AI chat feature, allowing AI assistants to query DuckDuckGo directly.
How to use ddg-mcp?
Install the package via uv install ddg-mcp or pip install ddg-mcp, then add it to your MCP client configuration (e.g., Claude Desktop) using the uvx command. Once configured, your AI assistant can invoke the provided tools (e.g., ddg-text-search, ddg-image-search) or use the search-results-summary prompt.
Key features of ddg-mcp
- DuckDuckGo text, image, news, and video search tools
- AI chat with multiple model options (GPT-4o mini, Llama 3.3 70B, Claude 3 Haiku, etc.)
- Search results summary prompt with optional detail level
- Customizable parameters: region, safesearch, timelimit, max_results
- Supports advanced search operators (filetype, site, intitle, inurl, etc.)
- Image-specific filters (size, color, type, layout, license)
Use cases of ddg-mcp
- An AI assistant retrieves current web information via DuckDuckGo text search
- A user searches for images with specific color or size constraints
- Finding recent news articles on a topic with a time limit
- Discovering educational videos filtered by duration and resolution
- Having a conversational AI interaction using DuckDuckGo’s AI chat
FAQ from ddg-mcp
What dependencies does ddg-mcp require?
Python 3.9 or higher and the duckduckgo-search package, which is installed automatically when you install ddg-mcp.
How do I configure ddg-mcp for Claude Desktop?
Add the server to your Claude Desktop configuration file (claude_desktop_config.json) with the command uvx ddg-mcp (for published servers) or a local path for development.
What search operators are available?
You can use operators such as "exact phrase", +/- to include/exclude, filetype:pdf, site:example.com, intitle:, and inurl:.
What parameters are common across all search tools?
Common parameters include region, safesearch, timelimit, and max_results. Default safesearch is "moderate" and max_results is 10.
Which AI chat models are supported?
Supported models: gpt-4o-mini, llama-3.3-70b, claude-3-haiku, o3-mini, and mistral-small-3.
