Integrations
Allows web search functionality using the DuckDuckGo search engine, providing knowledge graph information, organic search results, news articles, video content, image results, and related searches with support for region-specific search, safe search levels, and date-based filtering
mcp-duckduckgo-search
⚠️ Notice
This repository is no longer maintained.
The functionality of this tool is now available in mcp-omnisearch, which combines multiple MCP tools in one unified package.
Please use mcp-omnisearch instead.
A Model Context Protocol (MCP) server for integrating DuckDuckGo search capabilities with LLMs. This server provides comprehensive web search functionality with support for various result types and filtering options.
Features
- 🔍 Comprehensive web search using DuckDuckGo's search engine
- 📊 Rich result types including:
- Knowledge graph information
- Organic search results
- News articles
- Video content
- Image results
- Related searches
- 🌍 Region-specific search support
- 🛡️ Configurable safe search levels
- 📅 Date-based filtering options
- 📄 Pagination support
- 💾 Built-in result caching
- 🔒 Safe search options (off, moderate, strict)
Configuration
This server requires configuration through your MCP client. Here are examples for different environments:
Cline Configuration
Add this to your Cline MCP settings:
Claude Desktop with WSL Configuration
For WSL environments, add this to your Claude Desktop configuration:
Environment Variables
The server requires the following environment variable:
SERPAPI_KEY
: Your SerpAPI key (required)
API
The server implements a single MCP tool with configurable parameters:
ddg_search
Perform web searches using the DuckDuckGo search engine.
Parameters:
query
(string, required): Search queryregion
(string, optional): Region code (e.g., us-en, uk-en) (default: us-en)safe_search
(string, optional): Safe search level (off, moderate, strict) (default: moderate)date_filter
(string, optional): Filter results by date:- 'd': past day
- 'w': past week
- 'm': past month
- 'y': past year
- Custom range: '2023-01-01..2023-12-31'
start
(number, optional): Result offset for paginationno_cache
(boolean, optional): Bypass cache for fresh results (default: false)
Response includes:
- Knowledge graph data when available
- Organic search results
- News articles
- Video content
- Image results
- Related searches
- Search metadata
Development
Setup
- Clone the repository
- Install dependencies:
- Build the project:
- Run in development mode:
Publishing
The project uses changesets for version management. To publish:
- Create a changeset:
- Version the package:
- Publish to npm:
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
MIT License - see the LICENSE file for details.
Acknowledgments
- Built on the Model Context Protocol
- Powered by DuckDuckGo through SerpAPI
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Enables integration with DuckDuckGo search capabilities for LLMs, supporting comprehensive web search, regional filtering, result types, and safe browsing with caching and customizable search parameters.
Related Resources
Related MCP Servers
- -securityAlicense-qualityThis MCP server utilizes DuckDuckGo for web searches, providing structured search results with metadata and features like smart content classification and language detection, facilitating easy integration with AI clients supporting the MCP protocol.Last updated -1251JavaScriptMIT License
- AsecurityAlicenseAqualityIntegrates Tavily's search API with LLMs to provide advanced web search capabilities, including intelligent result summaries, domain filtering for quality control, and configurable search parameters.Last updated -3649JavaScriptMIT License
- -securityAlicense-qualityProvides web search functionality via DuckDuckGo for Claude Code and MCP-compatible clients, featuring advanced content exploration, navigation across search results, and detailed webpage analysis.Last updated -1PythonMIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that provides DuckDuckGo search functionality for Claude, enabling web search capabilities through a clean tool interface with rate limiting support.Last updated -16015TypeScriptMIT License