ddg-mcp MCP server
About
Perform web searches using the DuckDuckGo Search API.
Details
- Author
- misanthropic-ai
- GitHub stars
- 16
- Downloads
- 485
- Categories
- Search, Other
Jump to
- 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)
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
ddg-mcp MCP serverCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"ddg-mcp mcp server": {
"ddg-mcp": {
"command": "uv",
"args": [
"sync"
]
}
}
}
}McpServers
{
"ddg-mcp": {
"command": "uv",
"args": [
"sync"
]
}
}ddg-mcp MCP server
DuckDuckGo search API MCP - A server that provides DuckDuckGo search capabilities through the Model Context Protocol.
Components
Prompts
The server provides the following prompts:
- search-results-summary: Creates a summary of DuckDuckGo search results
- Required "query" argument for the search term
- Optional "style" argument to control detail level (brief/detailed)
Tools
The server implements the following DuckDuckGo search tools:
- ddg-text-search: Search the web for text results using DuckDuckGo
- Required: "keywords" - Search query keywords
- Optional: "region", "safesearch", "timelimit", "max_results"
- ddg-image-search: Search the web for images using DuckDuckGo
- Required: "keywords" - Search query keywords
- Optional: "region", "safesearch", "timelimit", "size", "color", "type_image", "layout", "license_image", "max_results"
- ddg-news-search: Search for news articles using DuckDuckGo
- Required: "keywords" - Search query keywords
- Optional: "region", "safesearch", "timelimit", "max_results"
- ddg-video-search: Search for videos using DuckDuckGo
- Required: "keywords" - Search query keywords
- Optional: "region", "safesearch", "timelimit", "resolution", "duration", "license_videos", "max_results"
- ddg-ai-chat: Chat with DuckDuckGo AI
- Required: "keywords" - Message or question to send to the AI
- Optional: "model" - AI model to use (options: "gpt-4o-mini", "llama-3.3-70b", "claude-3-haiku", "o3-mini", "mistral-small-3")
Installation
Prerequisites
- Python 3.9 or higher
- uv (recommended) or pip
Install from PyPI
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
