ddg-mcp-search

A minimal MCP server that exposes a single DuckDuckGo search tool.
Use this as a lean starting point for building your own MCP servers with a plugin architecture.

Features

• search tool — DuckDuckGo full-text search with region, time-limit, and safe-search options

• Plugin architecture — drop a new .py file into plugins/ and it is auto-discovered on startup

• SSE transport (compatible with Claude Desktop and other MCP clients)

Related MCP server: local-websearch-mcp

Requirements

• Python 3.10+

• pip packages listed in requirements.txt

Installation

git clone https://github.com/ss0832/ddg-mcp-search.git
cd ddg-mcp-search
pip install -r requirements.txt

Usage

python main.py

The server starts on http://0.0.0.0:9500 by default.

Connecting to Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "ddg-mcp-search": {
      "url": "http://localhost:9500/sse"
    }
  }
}

Tool reference

search

Search the web using DuckDuckGo.

Example response:

- DuckDuckGo — Privacy, simplified.
  URL: https://duckduckgo.com
  Snippet: The Internet privacy company that empowers you to seamlessly take control of your personal information online, without any tradeoffs.

Adding new tools

1. Create plugins/my_tool.py

2. Define a class inheriting MCPPlugin with get_tools() and call_tool() methods

3. Restart the server — it is discovered automatically

See plugins/web_search.py for a complete example.

License

MIT © 2026 ss0832