ddg-mcp logo

ddg-mcp

by misanthropic-ai

ddg-mcp is a server that provides DuckDuckGo search capabilities through the Model Context Protocol. It offers various tools for text, image, news, and video searches, as well as AI chat functionalities.

View on GitHub

Last updated: N/A

What is ddg-mcp?

ddg-mcp is a server that exposes the DuckDuckGo search API through the Model Context Protocol (MCP). It allows users to perform various types of searches, including text, image, news, and video, and provides an AI chat interface.

How to use ddg-mcp?

Install the server using uv or pip. Configure the server with the necessary dependencies. Use the provided tools and prompts with the required and optional arguments to perform searches or chat with the AI. Integrate the server into your MCP-compatible application.

Key features of ddg-mcp

  • Text Search

  • Image Search

  • News Search

  • Video Search

  • AI Chat

  • Search Results Summary

  • Configurable search parameters (region, safesearch, timelimit, max_results)

  • Support for search operators

Use cases of ddg-mcp

  • Integrating DuckDuckGo search into AI assistants

  • Building custom search tools

  • Automating information retrieval

  • Creating chatbots with search capabilities

FAQ from ddg-mcp

What is the Model Context Protocol (MCP)?

MCP is a protocol for communication between models and tools.

What search types are supported?

The server supports text, image, news, and video searches.

What are the required dependencies?

The server requires Python 3.9 or higher and the duckduckgo-search package.

How do I configure the search region?

Use the region parameter with the appropriate region code (e.g., 'us-en' for US English).

How do I debug the MCP server?

Use the MCP Inspector for the best debugging experience.