DuckDuckGo Web Search MCP Server

DuckDuckGo Web Search MCP Server

By kouui GitHub

MCP server of web search/fetch functionality using duckduckgo and jina api. no api key required.

Overview

What is DuckDuckGo Web Search MCP Server?

DuckDuckGo Web Search MCP Server is a project that provides a Model Context Protocol (MCP) server for searching the web using the DuckDuckGo search engine and optionally fetching and summarizing the content of the found URLs.

How to use DuckDuckGo Web Search MCP Server?

To use the server, you need to set it up with the uvx package manager and configure it in your MCP client (like Claude) to utilize the search and fetch functionalities.

Key features of DuckDuckGo Web Search MCP Server?

  • Web search using DuckDuckGo.
  • Extracts titles, URLs, and snippets from search results.
  • Optional content fetching and conversion to markdown format using Jina API.
  • Parallel fetching of multiple URLs for faster processing.
  • Configurable maximum number of search results.
  • Graceful error handling for timeouts and other issues.

Use cases of DuckDuckGo Web Search MCP Server?

  1. Conducting web searches without needing an API key.
  2. Fetching and summarizing content from multiple URLs concurrently.
  3. Integrating web search functionality into MCP-compatible applications.

FAQ from DuckDuckGo Web Search MCP Server?

  • Do I need an API key to use this server?

No, this server does not require an API key to perform web searches.

  • What is the maximum number of search results I can retrieve?

The default maximum is 3, but you can configure it to a maximum of 10.

  • Can I use this server with any MCP-compatible client?

Yes, it is designed to be compatible with any MCP client.

Content

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).

No tools information available.
No content found.