Skip to main content
Glama
Sign In
enesjakozh
DuckDuckGo Web Search MCP Server

DuckDuckGo Web Search MCP Server

by kouui
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

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.

Related MCP server: DuckDuckGo MCP Server

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

Available Tools

2 tools
fetchC
scrape the html content and return the markdown format using jina api.

Args:
    url: The search query string

Returns:
    text : html in markdown format

Inputs: url (required).

search_and_fetchA
Search the web using DuckDuckGo and return results.

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

Returns:
    List of dictionaries containing 
    - title
    - url
    - snippet 
    - summary markdown (empty if not available)

Inputs: query (required), limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    B3.3/5.0

    Scored across 2 tools

    Disambiguation4/5

    The two tools have distinct primary purposes: 'search_and_fetch' performs web searches and returns results, while 'fetch' scrapes HTML content from a given URL. However, there is some potential for confusion because 'fetch' accepts a 'url' argument but its description mentions 'search query string' (likely a documentation error), which could blur the boundary between searching and fetching.

    Naming Consistency4/5

    The tool names follow a consistent verb-based pattern ('fetch' and 'search_and_fetch'), with clear action-oriented naming. The minor deviation is that 'search_and_fetch' uses an 'and' conjunction, but overall the naming is readable and predictable.

    Tool Count3/5

    With only 2 tools, the server feels thin for a web search and scraping domain. While it covers basic search and fetch operations, more tools (e.g., for advanced search filtering, caching, or handling different content types) would provide better scope. It's borderline but not severely lacking.

    Completeness3/5

    The server covers core web search and content fetching workflows, but there are notable gaps. For example, it lacks tools for managing search history, refining queries, handling pagination, or supporting different output formats beyond markdown. Agents can work around these, but the surface is not fully comprehensive.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • DuckDuckGo MCP Server

      988664li-star
      A
      license
      B
      quality
      D
      maintenance
      Enables web search through DuckDuckGo and webpage content fetching with intelligent text extraction. Features built-in rate limiting and LLM-optimized result formatting for seamless integration with language models.
      2
      MIT

    • Web Search MCP

      pranavms13
      A
      license
      Not graded
      quality
      D
      maintenance
      Enables web searching through Google, DuckDuckGo, and Bing using a headless Chrome browser, returning structured results with titles, URLs, and snippets. Also supports fetching and extracting text content from any webpage.
      16
      MIT

    Appeared in Searches