What is Web Search Duckduckgo

web-search-duckduckgo is an MCP server that enables users to perform web searches using the DuckDuckGo search engine without requiring an API key. It also offers optional content fetching and summarization of the found URLs.

Use cases

Use cases include searching for information on specific topics, fetching and summarizing articles or web pages, and integrating web search functionality into applications or tools.

How to use

To use web-search-duckduckgo, install the uvx package manager, configure your MCP client (like Claude) with the server details, and utilize the provided tools such as search_and_fetch to execute searches and fetch content.

Key features

Key features include web search capabilities, result extraction (titles, URLs, snippets), optional content fetching in markdown format using the Jina API, parallel fetching for efficiency, error handling, and configurability for maximum search results.

Where to use

web-search-duckduckgo can be used in various fields such as research, content creation, and any application requiring web data retrieval and summarization.

DuckDuckGo Web Search MCP Server

This project provides an MCP (Model Context Protocol) server that allows you to search the web using the DuckDuckGo search engine and optionally fetch and summarize the content of the found URLs.

Features

• Web Search: Search the web using DuckDuckGo.
• Result Extraction: Extracts titles, URLs, and snippets from search results.
• Content Fetching (Optional): Fetches the content of the URLs found in the search results and converts it to markdown format using jina api.
• Parallel Fetching: Fetches multiple URLs concurrently for faster processing.
• Error Handling: Gracefully handles timeouts and other potential errors during search and fetching.
• Configurable: Allows you to set the maximum number of search results to return.
• Jina API: using jina api to convert html to markdown.
• MCP Compliant: This server is designed to be used with any MCP-compatible client.

Usage

1. Prerequisites:

   • uvx package manager

2. Claude Desktop Configuration

   • If you are using Claude Desktop, you can add the server to the claude_desktop_config.json file.

   {
     "mcpServers": {
       "web-search-duckduckgo": {
         "command": "uvx",
         "args": [
           "--from",
           "git+https://github.com/kouui/web-search-duckduckgo.git@main",
           "main.py"
         ]
       }
     }
   }
   

   the above configuration is not working, you might need to clone the repository to local pc and use the following configuration

   {
     "mcpServers": {
       "web-search-duckduckgo": {
         "command": "uv",
         "args": [
           "--directory",
           "/path/to/web-search-duckduckgo",
           "run",
           "main.py"
         ]
       }
     }
   }
   

3. Tool

   • In your MCP client (e.g., Claude), you can now use the following tools:

   • search_and_fetch: Search the web and fetch the content of the URLs.

     • query: The search query string.
     • limit: The maximum number of results to return (default: 3, maximum: 10).

   • fetch: Fetch the content of a specific URL.

     • url: The URL to fetch.

License

This project is licensed under the MIT License. (Add a license file if you want to specify a license).